[ { "type": "get", "url": "/api.php", "title": "01. Basic Information", "name": "Info", "group": "API", "description": "

Each API call will return the result in JSON format. There are 2 objects, "status" and "data".

The "status" object returns "ok" when the transaction is successful and "error" on failure.

The "data" object returns the requested data, as sub-objects.

The parameters must be sent either as POST['data'], json encoded array or independently as GET.

", "success": { "fields": { "Success 200": [ { "group": "Success 200", "type": "String", "optional": false, "field": "status", "description": "

"ok"

" }, { "group": "Success 200", "type": "String", "optional": false, "field": "data", "description": "

The data provided by the api will be under this object.

" } ] }, "examples": [ { "title": "Success-Response:", "content": "{\n \"status\":\"ok\",\n \"data\":{\n \"obj1\":\"val1\",\n \"obj2\":\"val2\",\n \"obj3\":{\n \"obj4\":\"val4\",\n \"obj5\":\"val5\"\n }\n }\n}", "type": "json" } ] }, "error": { "fields": { "Error 4xx": [ { "group": "Error 4xx", "type": "String", "optional": false, "field": "status", "description": "

"error"

" }, { "group": "Error 4xx", "type": "String", "optional": false, "field": "result", "description": "

Information regarding the error

" } ] }, "examples": [ { "title": "Error-Response:", "content": "{\n \"status\": \"error\",\n \"data\": \"The requested action could not be completed.\"\n}", "type": "json" } ] }, "version": "0.0.0", "filename": "./api.php", "groupTitle": "API" }, { "type": "get", "url": "/api.php?q=base58", "title": "03. base58", "name": "base58", "group": "API", "description": "

Converts a string to base58.

", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "string", "optional": false, "field": "data", "description": "

Input string

" } ] } }, "success": { "fields": { "Success 200": [ { "group": "Success 200", "type": "string", "optional": false, "field": "data", "description": "

Output string

" } ] } }, "version": "0.0.0", "filename": "./api.php", "groupTitle": "API" }, { "type": "get", "url": "/api.php?q=currentBlock", "title": "10. currentBlock", "name": "currentBlock", "group": "API", "description": "

Returns the current block.

", "success": { "fields": { "Success 200": [ { "group": "Success 200", "type": "string", "optional": false, "field": "id", "description": "

Blocks id

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "generator", "description": "

Block Generator

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "height", "description": "

Height

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "date", "description": "

Block's date in UNIX TIMESTAMP format

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "nonce", "description": "

Mining nonce

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "signature", "description": "

Signature signed by the generator

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "difficulty", "description": "

The base target / difficulty

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "argon", "description": "

Mining argon hash

" } ] } }, "version": "0.0.0", "filename": "./api.php", "groupTitle": "API" }, { "type": "get", "url": "/api.php?q=generateAccount", "title": "09. generateAccount", "name": "generateAccount", "group": "API", "description": "

Generates a new account. This function should only be used when the node is on the same host or over a really secure network.

", "success": { "fields": { "Success 200": [ { "group": "Success 200", "type": "string", "optional": false, "field": "address", "description": "

Account address

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "public_key", "description": "

Public key

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "private_key", "description": "

Private key

" } ] } }, "version": "0.0.0", "filename": "./api.php", "groupTitle": "API" }, { "type": "get", "url": "/api.php?q=getAddress", "title": "02. getAddress", "name": "getAddress", "group": "API", "description": "

Converts the public key to an ARO address.

", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "string", "optional": false, "field": "public_key", "description": "

The public key

" } ] } }, "success": { "fields": { "Success 200": [ { "group": "Success 200", "type": "string", "optional": false, "field": "data", "description": "

Contains the address

" } ] } }, "version": "0.0.0", "filename": "./api.php", "groupTitle": "API" }, { "type": "get", "url": "/api.php?q=getBalance", "title": "04. getBalance", "name": "getBalance", "group": "API", "description": "

Returns the balance of a specific account or public key.

", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "string", "optional": true, "field": "public_key", "description": "

Public key

" }, { "group": "Parameter", "type": "string", "optional": true, "field": "account", "description": "

Account id / address

" } ] } }, "success": { "fields": { "Success 200": [ { "group": "Success 200", "type": "string", "optional": false, "field": "data", "description": "

The ARO balance

" } ] } }, "version": "0.0.0", "filename": "./api.php", "groupTitle": "API" }, { "type": "get", "url": "/api.php?q=getBlock", "title": "11. getBlock", "name": "getBlock", "group": "API", "description": "

Returns the block.

", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "numeric", "optional": false, "field": "height", "description": "

Block Height

" } ] } }, "success": { "fields": { "Success 200": [ { "group": "Success 200", "type": "string", "optional": false, "field": "id", "description": "

Block id

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "generator", "description": "

Block Generator

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "height", "description": "

Height

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "date", "description": "

Block's date in UNIX TIMESTAMP format

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "nonce", "description": "

Mining nonce

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "signature", "description": "

Signature signed by the generator

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "difficulty", "description": "

The base target / difficulty

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "argon", "description": "

Mining argon hash

" } ] } }, "version": "0.0.0", "filename": "./api.php", "groupTitle": "API" }, { "type": "get", "url": "/api.php?q=getBlockTransactions", "title": "12. getBlockTransactions", "name": "getBlockTransactions", "group": "API", "description": "

Returns the transactions of a specific block.

", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "numeric", "optional": true, "field": "height", "description": "

Block Height

" }, { "group": "Parameter", "type": "string", "optional": true, "field": "block", "description": "

Block id

" } ] } }, "success": { "fields": { "Success 200": [ { "group": "Success 200", "type": "string", "optional": false, "field": "block", "description": "

Block ID

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "confirmation", "description": "

Number of confirmations

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "date", "description": "

Transaction's date in UNIX TIMESTAMP format

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "dst", "description": "

Transaction destination

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "fee", "description": "

The transaction's fee

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "height", "description": "

Block height

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "id", "description": "

Transaction ID/HASH

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "message", "description": "

Transaction's message

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "signature", "description": "

Transaction's signature

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "public_key", "description": "

Account's public_key

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "src", "description": "

Sender's address

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "type", "description": "

"debit", "credit" or "mempool"

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "val", "description": "

Transaction value

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "version", "description": "

Transaction version

" } ] } }, "version": "0.0.0", "filename": "./api.php", "groupTitle": "API" }, { "type": "get", "url": "/api.php?q=getPendingBalance", "title": "05. getPendingBalance", "name": "getPendingBalance", "group": "API", "description": "

Returns the pending balance, which includes pending transactions, of a specific account or public key.

", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "string", "optional": true, "field": "public_key", "description": "

Public key

" }, { "group": "Parameter", "type": "string", "optional": true, "field": "account", "description": "

Account id / address

" } ] } }, "success": { "fields": { "Success 200": [ { "group": "Success 200", "type": "string", "optional": false, "field": "data", "description": "

The ARO balance

" } ] } }, "version": "0.0.0", "filename": "./api.php", "groupTitle": "API" }, { "type": "get", "url": "/api.php?q=getPublicKey", "title": "08. getPublicKey", "name": "getPublicKey", "group": "API", "description": "

Returns the public key of a specific account.

", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "string", "optional": false, "field": "account", "description": "

Account id / address

" } ] } }, "success": { "fields": { "Success 200": [ { "group": "Success 200", "type": "string", "optional": false, "field": "data", "description": "

The public key

" } ] } }, "version": "0.0.0", "filename": "./api.php", "groupTitle": "API" }, { "type": "get", "url": "/api.php?q=getTransaction", "title": "07. getTransaction", "name": "getTransaction", "group": "API", "description": "

Returns one transaction.

", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "string", "optional": false, "field": "transaction", "description": "

Transaction ID

" } ] } }, "success": { "fields": { "Success 200": [ { "group": "Success 200", "type": "string", "optional": false, "field": "block", "description": "

Block ID

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "confirmation", "description": "

Number of confirmations

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "date", "description": "

Transaction's date in UNIX TIMESTAMP format

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "dst", "description": "

Transaction destination

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "fee", "description": "

The transaction's fee

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "height", "description": "

Block height

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "id", "description": "

Transaction ID/HASH

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "message", "description": "

Transaction's message

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "signature", "description": "

Transaction's signature

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "public_key", "description": "

Account's public_key

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "src", "description": "

Sender's address

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "type", "description": "

"debit", "credit" or "mempool"

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "val", "description": "

Transaction value

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "version", "description": "

Transaction version

" } ] } }, "version": "0.0.0", "filename": "./api.php", "groupTitle": "API" }, { "type": "get", "url": "/api.php?q=getTransactions", "title": "06. getTransactions", "name": "getTransactions", "group": "API", "description": "

Returns the latest transactions of an account.

", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "string", "optional": true, "field": "public_key", "description": "

Public key

" }, { "group": "Parameter", "type": "string", "optional": true, "field": "account", "description": "

Account id / address

" }, { "group": "Parameter", "type": "numeric", "optional": true, "field": "limit", "description": "

Number of confirmed transactions, max 1000, min 1

" } ] } }, "success": { "fields": { "Success 200": [ { "group": "Success 200", "type": "string", "optional": false, "field": "block", "description": "

Block ID

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "confirmation", "description": "

Number of confirmations

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "date", "description": "

Transaction's date in UNIX TIMESTAMP format

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "dst", "description": "

Transaction destination

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "fee", "description": "

The transaction's fee

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "height", "description": "

Block height

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "id", "description": "

Transaction ID/HASH

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "message", "description": "

Transaction's message

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "signature", "description": "

Transaction's signature

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "public_key", "description": "

Account's public_key

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "src", "description": "

Sender's address

" }, { "group": "Success 200", "type": "string", "optional": false, "field": "type", "description": "

"debit", "credit" or "mempool"

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "val", "description": "

Transaction value

" }, { "group": "Success 200", "type": "numeric", "optional": false, "field": "version", "description": "

Transaction version

" } ] } }, "version": "0.0.0", "filename": "./api.php", "groupTitle": "API" }, { "type": "get", "url": "/api.php?q=mempoolSize", "title": "15. mempoolSize", "name": "mempoolSize", "group": "API", "description": "

Returns the number of transactions in mempool.

", "success": { "fields": { "Success 200": [ { "group": "Success 200", "type": "numeric", "optional": false, "field": "data", "description": "

Number of mempool transactions

" } ] } }, "version": "0.0.0", "filename": "./api.php", "groupTitle": "API" }, { "type": "get", "url": "/api.php?q=send", "title": "14. send", "name": "send", "group": "API", "description": "

Sends a transaction.

", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "numeric", "optional": false, "field": "val", "description": "

Transaction value (without fees)

" }, { "group": "Parameter", "type": "string", "optional": false, "field": "dst", "description": "

Destination address

" }, { "group": "Parameter", "type": "string", "optional": false, "field": "public_key", "description": "

Sender's public key

" }, { "group": "Parameter", "type": "string", "optional": true, "field": "signature", "description": "

Transaction signature. It's recommended that the transaction is signed before being sent to the node to avoid sending your private key to the node.

" }, { "group": "Parameter", "type": "string", "optional": true, "field": "private_key", "description": "

Sender's private key. Only to be used when the transaction is not signed locally.

" }, { "group": "Parameter", "type": "numeric", "optional": true, "field": "date", "description": "

Transaction's date in UNIX TIMESTAMP format. Requried when the transaction is pre-signed.

" }, { "group": "Parameter", "type": "string", "optional": true, "field": "message", "description": "

A message to be included with the transaction. Maximum 128 chars.

" }, { "group": "Parameter", "type": "numeric", "optional": true, "field": "version", "description": "

The version of the transaction. 1 to send coins.

" } ] } }, "success": { "fields": { "Success 200": [ { "group": "Success 200", "type": "string", "optional": false, "field": "data", "description": "

Transaction id

" } ] } }, "version": "0.0.0", "filename": "./api.php", "groupTitle": "API" }, { "type": "get", "url": "/api.php?q=version", "title": "13. version", "name": "version", "group": "API", "description": "

Returns the node's version.

", "success": { "fields": { "Success 200": [ { "group": "Success 200", "type": "string", "optional": false, "field": "data", "description": "

Version

" } ] } }, "version": "0.0.0", "filename": "./api.php", "groupTitle": "API" }, { "success": { "fields": { "Success 200": [ { "group": "Success 200", "optional": false, "field": "varname1", "description": "

No type.

" }, { "group": "Success 200", "type": "String", "optional": false, "field": "varname2", "description": "

With type.

" } ] } }, "type": "", "url": "", "version": "0.0.0", "filename": "./doc/main.js", "group": "_github_node_doc_main_js", "groupTitle": "_github_node_doc_main_js", "name": "" } ]