[ { "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": "" } ]