Address

Metacoin Address and balance

Create new Adderess

Warning!!

• An ECDSA private key that is paired with the ECDSA public key is used to authorize the transfer.
• When you make your wallet, please keep the Private Key that is paired with the Public Key you sent in a safe place.
• If you lose your private key, you can not claim your wallet.
• ECDSA curve is prime256v1(secp256r1) or secp384r1 or secp521r1.

POSThttps://rest.metacoin.network:20923/address

Query parameters

Response

200405

successful operation

Body

*/*

string (Metacoin Address)

new Metacoin address

Request

const crypto = require('crypto');
const axios = require('axios');

// testnet
var hostname = "https://testnetrest.metacoin.network:20923";
// mainnet
// hostname = "https://rest.metacoin.network:20923";

function create_address() {
    return new Promise((resolve, reject) => {
        crypto.generateKeyPair("ec", {
            namedCurve: "secp384r1",  // prime256v1, secp384r1, secp521r1
            publicKeyEncoding: {
                type: 'spki',
                format: 'pem'
            },
            privateKeyEncoding: {
                type: 'pkcs8',
                format: 'pem'
            }
        }, (err, public_key, private_key) => {
            if (err != null) {
                return reject(err.message);
            }

            axios.post(hostname + '/address', {
                'publickey': public_key
            })
                .then(function (response) {
                    if (response.status != 200) {
                        return Promise.reject("MTC server response errror");
                    } else {
                        return Promise.resolve(response.data);
                    }
                })
                .then(function (mtc_address) {
                    return resolve({ "Address": mtc_address, "publicKey": public_key, "PrivateKey": private_key });
                })
                .catch(function (error) {
                    return reject(error);
                });
        });
    });
}

create_address()
    .then((v) => {
        console.log('Metacoin Address', v.Address);
        console.log('Public Key', v.publicKey);
        console.log('Private Key', v.PrivateKey);
    })
    .catch((err) => {
        console.log(err);
    });

Response

"text"

Get address status

GEThttps://rest.metacoin.network:20923/address/{address}

Path parameters

address*string (Metacoin Address)

Metacoin address

Response

200404

successful operation

Body

*/*

addressstring (metacoin address)

createdateinteger (int32)

Unix Timesamp(UTC)

balancearray of balance (object)

Request

JavaScriptCurl

const response = await fetch('https://rest.metacoin.network:20923/address/{address}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "address": "text",
  "balance": [
    {
      "token": "text",
      "balance": "text"
    }
  ]
}

Get address list by public key

POSThttps://rest.metacoin.network:20923/address/bykey

Query parameters

Response

200404

successful operation

Body

*/*

itemsstring (Metacoin Address)

Request

const crypto = require('crypto');
const axios = require('axios');

// testnet
var hostname = "https://testnetrest.metacoin.network:20923";
// mainnet
// hostname = "https://rest.metacoin.network:20923";

var public_key = "-----BEGIN PUBLIC KEY-----\nMIGbMBAGByqGSM49AgEGBSuBBAAjA4GGAAQBBp5oHHFaATF1UIephJYgtW+u2+aT\nhZLxNgn5JZhgFXzvTUHlThZxb61eTXMMjyU/IloNznwtzRWuPq1oMDOMq9oBbT/t\nE4lgyPF5/QtzuhaaYRpr/ahZ4JSLyHOegkopXeic3UFUmkpb4mXuSGgu5mChuuUC\nktjfluGNtvXHOWYtqTU=\n-----END PUBLIC KEY-----";
// public_key = "MIGbMBAGByqGSM49AgEGBSuBBAAjA4GGAAQBBp5oHHFaATF1UIephJYgtW+u2+aThZLxNgn5JZhgFXzvTUHlThZxb61eTXMMjyU/IloNznwtzRWuPq1oMDOMq9oBbT/tE4lgyPF5/QtzuhaaYRpr/ahZ4JSLyHOegkopXeic3UFUmkpb4mXuSGgu5mChuuUCktjfluGNtvXHOWYtqTU=";

axios.post(hostname + '/address/bykey', {
  'publickey': public_key
}, {
  proxy: {
    host: '127.0.0.1',
    port: 8888
  }
})
  .then(function (response) {
    if (response.status != 200) {
      return Promise.reject("Metacoin server response error");
    } else {
      return Promise.resolve(response.data);
    }
  })
  .then(function (mtc_address) {
    // ["MT4FzIQCgRh0T1YD841OxjNd3dkfTJcEd41d17d3"]
    console.log(mtc_address);
  })
  .catch(function (error) {
    if (error.response.status == 404) {
      console.log("Address not found");
    } else {
      console.log(error);
    }
  });

Response

[
  "MTATLnT6SGKE8RU0CBPoDRfUXL5lr4SLece1a6ee"
]

Get Temporary key(nonce) for ganerate transaction(ex Transfer, Dapp Create or Token Create)

• By using the signature value recorded in the transaction, the key value is obtained to prevent duplicate calls by other users.
• In the existing blockchain, the nonce value is a serial number that means the number of TX occurrences, but in Metacoin, it is a random key value.
• This command replaces the existing "getkey" API.

GEThttps://rest.metacoin.network:20923/nonce/{address}

Path parameters

address*string (Metacoin address)

Address to get nonce value

Response

200400

successful operation

Body

*/*

string

Temporary key for transaction

Request

JavaScriptCurl

const response = await fetch('https://rest.metacoin.network:20923/nonce/{address}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

"text"

Get balance of address

GEThttps://rest.metacoin.network:20923/balance/{address}

Path parameters

address*string (Metacoin address)

Metacoin address

Response

200404

successful operation

Body

*/*

tokenstring (integer)

balancestring (integer)

unlockdateinteger (int32)

Unix Timesamp(UTC) of withdrawal

Request

JavaScriptCurl

const response = await fetch('https://rest.metacoin.network:20923/balance/{address}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "token": "text",
  "balance": "text"
}