sido/node
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

documentation + base58 fix

Browse Source
This commit is contained in:
Arionum
2018-02-22 19:22:28 +02:00
parent e1971dd741
commit 8a648dcc8a
18 changed files with 1749 additions and 226 deletions
Download Patch File Download Diff File Expand all files Collapse all files

294
util.php
View File

@@ -23,10 +23,25 @@ DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE
OR OTHER DEALINGS IN THE SOFTWARE.
*/
// make sure it's not accessible in the browser
if(php_sapi_name() !== 'cli') die("This should only be run as cli");
require_once("include/init.inc.php");
$cmd=trim($argv[1]);
/**
* @api {php util.php} clean Clean
* @apiName clean
* @apiGroup UTIL
* @apiDescription Cleans the entire database
*
* @apiExample {cli} Example usage:
* php util.php clean
*/
if($cmd=='clean'){
$tables=array("blocks","accounts","transactions","mempool");
@@ -37,12 +52,39 @@ echo "\n The database has been cleared\n";
}
/**
* @api {php util.php} pop Pop
* @apiName pop
* @apiGroup UTIL
* @apiDescription Cleans the entire database
*
* @apiParam {Number} arg2 Number of blocks to delete
*
* @apiExample {cli} Example usage:
* php util.php pop 1
*/
elseif($cmd=='pop'){
$no=intval($argv[2]);
$block=new Block;
$block->pop($no);
}
/**
* @api {php util.php} block-time Block-time
* @apiName block-time
* @apiGroup UTIL
* @apiDescription Shows the block time of the last 100 blocks
*
* @apiExample {cli} Example usage:
* php util.php block-time
*
* @apiSuccessExample {text} Success-Response:
* 16830 -> 323
* ...
* 16731 -> 302
* Average block time: 217 seconds
*/
elseif($cmd=='block-time'){
$t=time();
@@ -59,16 +101,86 @@ echo "Average block time: ".ceil(($start-$end)/100)." seconds\n";
}
/**
* @api {php util.php} peer Peer
* @apiName peer
* @apiGroup UTIL
* @apiDescription Creates a peering session with another node
*
* @apiParam {text} arg2 The Hostname of the other node
*
* @apiExample {cli} Example usage:
* php util.php peer http://peer1.arionum.com
*
* @apiSuccessExample {text} Success-Response:
* Peering OK
*/
elseif($cmd=="peer"){
$res=peer_post($argv[2]."/peer.php?q=peer",array("hostname"=>$_config['hostname']));
if($res!==false) echo "Peering OK\n";
else echo "Peering FAIL\n";
}
/**
* @api {php util.php} current Current
* @apiName current
* @apiGroup UTIL
* @apiDescription Prints the current block in var_dump
*
* @apiExample {cli} Example usage:
* php util.php current
*
* @apiSuccessExample {text} Success-Response:
* array(9) {
* ["id"]=>
* string(88) "4khstc1AknzDXg8h2v12rX42vDrzBaai6Rz53mbaBsghYN4DnfPhfG7oLZS24Q92MuusdYmwvDuiZiuHHWgdELLR"
* ["generator"]=>
* string(88) "5ADfrJUnLefPsaYjMTR4KmvQ79eHo2rYWnKBRCXConYKYJVAw2adtzb38oUG5EnsXEbTct3p7GagT2VVZ9hfVTVn"
* ["height"]=>
* int(16833)
* ["date"]=>
* int(1519312385)
* ["nonce"]=>
* string(41) "EwtJ1EigKrLurlXROuuiozrR6ICervJDF2KFl4qEY"
* ["signature"]=>
* string(97) "AN1rKpqit8UYv6uvf79GnbjyihCPE1UZu4CGRx7saZ68g396yjHFmzkzuBV69Hcr7TF2egTsEwVsRA3CETiqXVqet58MCM6tu"
* ["difficulty"]=>
* string(8) "61982809"
* ["argon"]=>
* string(68) "$SfghIBNSHoOJDlMthVcUtg$WTJMrQWHHqDA6FowzaZJ+O9JC8DPZTjTxNE4Pj/ggwg"
* ["transactions"]=>
* int(0)
* }
*
*/
elseif ($cmd=="current") {
$block=new Block;
var_dump($block->current());
} elseif($cmd=="blocks"){
}
/**
* @api {php util.php} blocks Blocks
* @apiName blocks
* @apiGroup UTIL
* @apiDescription Prints the id and the height of the blocks >=arg2, max 100 or arg3
*
* @apiParam {number} arg2 Starting height
*
* @apiParam {number} [arg3] Block Limit
*
* @apiExample {cli} Example usage:
* php util.php blocks 10800 5
*
* @apiSuccessExample {text} Success-Response:
* 10801 2yAHaZ3ghNnThaNK6BJcup2zq7EXuFsruMb5qqXaHP9M6JfBfstAag1n1PX7SMKGcuYGZddMzU7hW87S5ZSayeKX
* 10802 wNa4mRvRPCMHzsgLdseMdJCvmeBaCNibRJCDhsuTeznJh8C1aSpGuXRDPYMbqKiVtmGAaYYb9Ze2NJdmK1HY9zM
* 10803 3eW3B8jCFBauw8EoKN4SXgrn33UBPw7n8kvDDpyQBw1uQcmJQEzecAvwBk5sVfQxUqgzv31JdNHK45JxUFcupVot
* 10804 4mWK1f8ch2Ji3D6aw1BsCJavLNBhQgpUHBCHihnrLDuh8Bjwsou5bQDj7D7nV4RsEPmP2ZbjUUMZwqywpRc8r6dR
* 10805 5RBeWXo2c9NZ7UF2ubztk53PZpiA4tsk3bhXNXbcBk89cNqorNj771Qu4kthQN5hXLtu1hzUnv7nkH33hDxBM34m
*
*/
elseif($cmd=="blocks"){
$height=intval($argv[2]);
$limit=intval($argv[3]);
if($limit<1) $limit=100;
@@ -77,7 +189,16 @@ elseif ($cmd=="current") {
echo "$x[height]\t$x[id]\n";
}
}
/**
* @api {php util.php} recheck-blocks Recheck-Blocks
* @apiName recheck-blocks
* @apiGroup UTIL
* @apiDescription Recheck all the blocks to make sure the blockchain is correct
*
* @apiExample {cli} Example usage:
* php util.php recheck-blocks
*
*/
elseif($cmd=="recheck-blocks"){
$blocks=array();
$block=new Block();
@@ -96,17 +217,61 @@ elseif($cmd=="recheck-blocks"){
break;
}
}
} elseif($cmd=="peers"){
$r=$db->run("SELECT * FROM peers ORDER by reserve ASC LIMIT 100");
}
/**
* @api {php util.php} peers Peers
* @apiName peers
* @apiGroup UTIL
* @apiDescription Prints all the peers and their status
*
* @apiExample {cli} Example usage:
* php util.php peers
*
* @apiSuccessExample {text} Success-Response:
* http://35.190.160.142 active
* ...
* http://aro.master.hashpi.com active
*/
elseif($cmd=="peers"){
$r=$db->run("SELECT * FROM peers ORDER by reserve ASC");
$status="active";
if($x['reserve']==1) $status="reserve";
foreach($r as $x){
echo "$x[hostname]\t$x[reserve]\n";
echo "$x[hostname]\t$status\n";
}
} elseif($cmd=="mempool"){
}
/**
* @api {php util.php} mempool Mempool
* @apiName mempool
* @apiGroup UTIL
* @apiDescription Prints the number of transactions in mempool
*
* @apiExample {cli} Example usage:
* php util.php mempool
*
* @apiSuccessExample {text} Success-Response:
* Mempool size: 12
*/
elseif($cmd=="mempool"){
$res=$db->single("SELECT COUNT(1) from mempool");
echo "Mempool size: $res\n";
} elseif($cmd=="delete-peer"){
}
/**
* @api {php util.php} delete-peer Delete-peer
* @apiName delete-peer
* @apiGroup UTIL
* @apiDescription Removes a peer from the peerlist
*
* @apiParam {text} arg2 Peer's hostname
*
* @apiExample {cli} Example usage:
* php util.php delete-peer http://peer1.arionum.com
*
* @apiSuccessExample {text} Success-Response:
* Peer removed
*/
elseif($cmd=="delete-peer"){
$peer=trim($argv[2]);
if(empty($peer)) die("Invalid peer");
$db->run("DELETE FROM peers WHERE ip=:ip",array(":ip"=>$peer));
@@ -121,7 +286,23 @@ echo "Mempool size: $res\n";
} else echo "$x[hostname] ->ok \n";
}
}elseif($cmd=="peers-block"){
}
/**
* @api {php util.php} peers-block Peers-Block
* @apiName peers-block
* @apiGroup UTIL
* @apiDescription Prints the current height of all the peers
*
* @apiExample {cli} Example usage:
* php util.php peers-block
*
* @apiSuccessExample {text} Success-Response:
* http://peer5.arionum.com 16849
* ...
* http://peer10.arionum.com 16849
*/
elseif($cmd=="peers-block"){
$r=$db->run("SELECT * FROM peers");
foreach($r as $x){
$a=peer_post($x['hostname']."/peer.php?q=currentBlock",array(),5);
@@ -130,17 +311,85 @@ echo "Mempool size: $res\n";
echo "$x[hostname]\t$a[height]\n";
}
}elseif($cmd=="balance"){
}
/**
* @api {php util.php} balance Balance
* @apiName balance
* @apiGroup UTIL
* @apiDescription Prints the balance of an address or a public key
*
* @apiParam {text} arg2 address or public_key
*
* @apiExample {cli} Example usage:
* php util.php balance 5WuRMXGM7Pf8NqEArVz1NxgSBptkimSpvuSaYC79g1yo3RDQc8TjVtGH5chQWQV7CHbJEuq9DmW5fbmCEW4AghQr
*
* @apiSuccessExample {text} Success-Response:
* Balance: 2,487
*/
elseif($cmd=="balance"){
$id=san($argv[2]);
$res=$db->single("SELECT balance FROM accounts WHERE id=:id OR public_key=:id2 LIMIT 1",array(":id"=>$id, ":id2"=>$id));
echo "Balance: ".number_format($res)."\n";
}elseif($cmd=="block"){
}
/**
* @api {php util.php} block Block
* @apiName block
* @apiGroup UTIL
* @apiDescription Returns a specific block
*
* @apiParam {text} arg2 block id
*
* @apiExample {cli} Example usage:
* php util.php block 4khstc1AknzDXg8h2v12rX42vDrzBaai6Rz53mbaBsghYN4DnfPhfG7oLZS24Q92MuusdYmwvDuiZiuHHWgdELLR
*
* @apiSuccessExample {text} Success-Response:
* array(9) {
* ["id"]=>
* string(88) "4khstc1AknzDXg8h2v12rX42vDrzBaai6Rz53mbaBsghYN4DnfPhfG7oLZS24Q92MuusdYmwvDuiZiuHHWgdELLR"
* ["generator"]=>
* string(88) "5ADfrJUnLefPsaYjMTR4KmvQ79eHo2rYWnKBRCXConYKYJVAw2adtzb38oUG5EnsXEbTct3p7GagT2VVZ9hfVTVn"
* ["height"]=>
* int(16833)
* ["date"]=>
* int(1519312385)
* ["nonce"]=>
* string(41) "EwtJ1EigKrLurlXROuuiozrR6ICervJDF2KFl4qEY"
* ["signature"]=>
* string(97) "AN1rKpqit8UYv6uvf79GnbjyihCPE1UZu4CGRx7saZ68g396yjHFmzkzuBV69Hcr7TF2egTsEwVsRA3CETiqXVqet58MCM6tu"
* ["difficulty"]=>
* string(8) "61982809"
* ["argon"]=>
* string(68) "$SfghIBNSHoOJDlMthVcUtg$WTJMrQWHHqDA6FowzaZJ+O9JC8DPZTjTxNE4Pj/ggwg"
* ["transactions"]=>
* int(0)
* }
*/
elseif($cmd=="block"){
$id=san($argv[2]);
$res=$db->row("SELECT * FROM blocks WHERE id=:id OR height=:id2 LIMIT 1",array(":id"=>$id, ":id2"=>$id));
var_dump($res);
}elseif($cmd=="check-address"){
}
/**
* @api {php util.php} check-address Check-Address
* @apiName check-address
* @apiGroup UTIL
* @apiDescription Checks a specific address for validity
*
* @apiParam {text} arg2 block id
*
* @apiExample {cli} Example usage:
* php util.php check-address 4khstc1AknzDXg8h2v12rX42vDrzBaai6Rz53mbaBsghYN4DnfPhfG7oLZS24Q92MuusdYmwvDuiZiuHHWgdELLR
*
* @apiSuccessExample {text} Success-Response:
* The address is valid
*/
elseif($cmd=="check-address"){
$dst=trim($argv[2]);
$acc=new Account;
if(!$acc->valid($dst)) die("Invalid address");
@@ -148,6 +397,27 @@ echo "Mempool size: $res\n";
if(strlen($dst_b)!=64) die("Invalid address - ".strlen($dst_b)." bytes");
echo "The address is valid\n";
}
/**
* @api {php util.php} get-address Get-Address
* @apiName get-address
* @apiGroup UTIL
* @apiDescription Converts a public key into an address
*
* @apiParam {text} arg2 public key
*
* @apiExample {cli} Example usage:
* php util.php get-address PZ8Tyr4Nx8MHsRAGMpZmZ6TWY63dXWSCwQr8cE5s6APWAE1SWAmH6NM1nJTryBURULEsifA2hLVuW5GXFD1XU6s6REG1iPK7qGaRDkGpQwJjDhQKVoSVkSNp
*
* @apiSuccessExample {text} Success-Response:
* 5WuRMXGM7Pf8NqEArVz1NxgSBptkimSpvuSaYC79g1yo3RDQc8TjVtGH5chQWQV7CHbJEuq9DmW5fbmCEW4AghQr
*/
elseif($cmd=='get-address'){
$public_key=trim($argv2);
if(strlen($public_key)<32) die("Invalid public key");
print($acc->get_address($public_key));
} else {
echo "Invalid command\n";