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

Response

200

text

<?php
// Create New Address example code


// Create new key pair
$new_key_pair = openssl_pkey_new(array(
    "private_key_type" => OPENSSL_KEYTYPE_EC,
    'curve_name' => 'secp384r1',
));
openssl_pkey_export($new_key_pair, $private_key_pem);
$details = openssl_pkey_get_details($new_key_pair);
$public_key_pem = $details['key'];

$param = array(
	'publickey' => $public_key_pem,
	'addinfo' => 'new address'
);

// HTTP Request
$curl = curl_init();
$opt = curl_setopt_array($curl, array(
	CURLOPT_URL => 'https://testnetrest.metacoin.network:20923/address',
	CURLOPT_RETURNTRANSFER => true,
	CURLOPT_CONNECTTIMEOUT => 5,
	CURLOPT_TIMEOUT => 20,
	CURLOPT_SSL_VERIFYPEER => false,
	CURLOPT_SSL_VERIFYHOST => false,
	CURLOPT_POST => false,
	CURLOPT_POSTFIELDS => http_build_query($param),
	CURLOPT_POST => true,
));
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/x-www-form-urlencoded'));

$body = curl_exec($curl);
if(curl_errno($curl)){
	$http_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);
	printf("API Error [%d] %s", $http_code, $body);
	exit;
}

printf("New Address : %s\n", $body);
printf("Private Key : %s\n", $private_key_pem);

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

JavaScriptCurlPython

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

Response

200

{
  "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)

Example: "MTATLnT6SGKE8RU0CBPoDRfUXL5lr4SLece1a6ee"

Response

200

[
  "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

JavaScriptCurlPython

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

Response

200

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

JavaScriptCurlPython

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

Response

200

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