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.

post

/address

Query parameters

publickeystring · pem encodingrequired

ECDSA Public key for signing

addinfostring · max: 2048

• Address memo
• Up to 2048 characters are stored, and characters after 2048 characters are not stored.

Responses

*/*

200

405

200

text

successful operation

<?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

get

/address/{address}

Path parameters

addressstring · Metacoin Addressrequired

Metacoin address

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://rest.metacoin.network:20923/address/{address}'

200

404

200

{
  "address": "text",
  "createdate": 1,
  "balance": [
    {
      "token": "text",
      "balance": "text",
      "unlockdate": 1
    }
  ]
}

successful operation

Get address list by public key

post

/address/bykey

Query parameters

publickeystringrequired

• Metacoin address's public key
• ignore carriage return, line feed, "-----BEGIN PUBLIC KEY-----", "-----END PUBLIC KEY-----"

Example: -----BEGIN PUBLIC KEY-----\nMIGbMBAGByqGSM49AgEGBSuBBAAjA4GGAAQBBp5oHHFaATF1UIephJYgtW+u2+aT\nhZLxNgn5JZhgFXzvTUHlThZxb61eTXMMjyU/IloNznwtzRWuPq1oMDOMq9oBbT/t\nE4lgyPF5/QtzuhaaYRpr/ahZ4JSLyHOegkopXeic3UFUmkpb4mXuSGgu5mChuuUC\nktjfluGNtvXHOWYtqTU=\n-----END PUBLIC KEY-----

Responses

*/*

200

404

200

[
  "MTATLnT6SGKE8RU0CBPoDRfUXL5lr4SLece1a6ee"
]

successful operation

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.

get

/nonce/{address}

Path parameters

addressstring · Metacoin addressrequired

Address to get nonce value

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://rest.metacoin.network:20923/nonce/{address}'

200

400

200

text

successful operation

Get balance of address

get

/balance/{address}

Path parameters

addressstring · Metacoin addressrequired

Metacoin address

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://rest.metacoin.network:20923/balance/{address}'

200

404

200

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

successful operation