myNanoPHP is a C library that integrates Nano Cryptocurrency tools to PHP
- Integrated Proof of Work with multithread CPU support
- Self entropy verifier to ensure excelent TRNG or PRNG entropy
- Bip39
- Brainwallet support
- P2PoW support
- Sign a block using Blake2b hash with Ed25519 algorithm
- Optmized for size and speed
- Integration with IoT protocol devices (in development)
- Bitcoin support (In development)
- Creates a encrypted stream by password to protect your SEED
- Written in C
- Libsodium and mbedTLS libraries integrated
- Only 560 KB in your server disk space
- Build with myNanoEmbedded library
(in development)
(in development)
(in development)
(in development)
(in development)
(in development)
There is a POC (Proof of Concept) implementing myNanoPHP Library in ReactJS for developers to test and start using this library reading README_API template tutorial
Function [ <internal:mynanoembedded> function php_c_add_sub_balance ] {
- Parameters [3] {
Parameter #0 [ <required> $valueA ]
Parameter #1 [ <required> $valueB ]
Parameter #2 [ <required> $type ]
}
}Adds or Subtracts two Nano big numbers
$res = php_c_add_sub_balance($valueA, $valueB, $type);Where:
$res = $valueA + $valueB or $res = $valueA - $valueB
| params | description |
|---|---|
| $valueA | A value |
| $valueB | B value |
| $type | Big numbers types |
| $type | Type description |
|---|---|
| NANO_ADD_A_B | Return value is A + B |
| NANO_SUB_A_B | Return value is A - B |
| NANO_RES_RAW_128 | Return value is hex string |
| NANO_RES_RAW_STRING | Reurn value is Nano raw string |
| NANO_RES_REAL_STRING | Return value is Nano real string |
| NANO_A_RAW_128 | Input value A is a raw hex string |
| NANO_A_RAW_STRING | Input value A is Nano raw string |
| NANO_A_REAL_STRING | Input value A is Nano real string |
| NANO_B_RAW_128 | Input value B is a raw hex string |
| NANO_B_RAW_STRING | Input value B is Nano raw string |
| NANO_B_REAL_STRING | Input value B is Nano real string |
A real/hex/raw string value of addition/subtraction operation
Add two real values "1.3" + "2.5" = ?
php -r "echo php_c_add_sub_balance('1.3', '2.5', NANO_ADD_A_B|NANO_RES_REAL_STRING|NANO_A_REAL_STRING|NANO_B_REAL_STRING);"Return value
3.8 # => 1.3 + 2.5Subtract one real value "10.31791" minus Nano raw value "3671790000000000000000000000000" and return a real value
php -r "echo php_c_add_sub_balance('10.31791', '3671790000000000000000000000000', NANO_SUB_A_B|NANO_RES_REAL_STRING|NANO_A_REAL_STRING|NANO_B_RAW_STRING);"Return value
6.64612 # => 10.31791(REAL) - 3671790000000000000000000000000(RAW) = 6.64612(REAL)
# Human readable result 10.31791 - 3.67179 = 6.64612Add one Nano raw value "6389710900000000000000000000000000" plus Nano hex value "00002363AEAAB97F08117CAFF4200000" and return a Nano raw value
php -r "echo php_c_add_sub_balance('6389710900000000000000000000000000', '00002363AEAAB97F08117CAFF4200000', NANO_ADD_A_B|NANO_RES_RAW_STRING|NANO_A_RAW_STRING|NANO_B_RAW_128);"Return value
7107492881001800000000000000000000 # => 6389710900000000000000000000000000(RAW) + 00002363AEAAB97F08117CAFF4200000(HEX) = 7107492881001800000000000000000000(RAW)
# Human readable result 6389.7109 + 717.7819810018 = 7107.4928810018On error
Throws MyNanoCEmbeddedException
Function [ <internal:mynanoembedded> function php_c_bip39_to_nano_seed ] {
- Parameters [2] {
Parameter #0 [ <required> $bip39 ]
Parameter #1 [ <required> $dictionary_path ]
}
}Extract Nano SEED from Bip39 menemonic
$res = php_c_bip39_to_nano_seed($bip39, $dictionary_path);| params | type | description |
|---|---|---|
| $bip39 | string | Bip39 mnemonic |
| $dictionary | string | Path and file to dictionary file *.dic |
Nano SEED in hex string format
Extract Nano SEED from Bip39 menemonic "mesh clap laptop idea vocal stadium spoil buyer parent main worry siren scout theme country ridge universe pen cage bless robot seek inner latin" using English Bip39 dictionary
php -r "echo php_c_bip39_to_nano_seed('mesh clap laptop idea vocal stadium spoil buyer parent main worry siren scout theme country ridge universe pen cage bless robot seek inner latin', '/var/www/html/dictionary.dic');"Return value
8BC539F4383F55A7F490FBA030CBF764BC15C00C45CCEDD44C808BDBB3861D1B
# => YOUR NANO SEED. Don't tell your SEED and Bip39 menemonic to anyone. Keep it SAFE !
# Expose your SEED or Mnemonic everybody will have access to your fundsOn error
Throws MyNanoCEmbeddedException
Function [ <internal:mynanoembedded> function php_c_block_to_p2pow ] {
- Parameters [5] {
Parameter #0 [ <required> $block ]
Parameter #1 [ <required> $worker_wallet ]
Parameter #2 [ <required> $worker_representative ]
Parameter #3 [ <required> $worker_fee ]
Parameter #4 [ <optional> $worker_fee_type ]
}
}Converts a Nano binary block to P2PoW binary format adding fee for Proof of Work computation
$res = php_c_block_to_p2pow($block, $worker_wallet, $worker_representative, $worker_fee, $worker_fee_type);| params | type | description |
|---|---|---|
| $block | binary | Binary Nano Block |
| $worker_wallet | string | Worker wallet |
| $worker_representative | string | Worker representative. If empty string then function clones user representative to worker representative |
| $worker_fee | string | Fee to computate Proof of Work |
| $worker_type | integer | (Optional) Fee type. If ommited fee type is real string |
| type | description |
|---|---|
| WORKER_FEE_HEX | Fee value is hex string big number |
| WORKER_FEE_REAL | Fee value is a real string |
| WORKER_FEE_RAW | Fee value is Nano Raw |
Binary block to variable
Create a file "create_p2pow_block.php" and type:
<?php
//sat May 23 2020 14:50:23 -03
/*
* EXAMPLE: Creates a Nano block and add fee to P2PoW block
*/
echo "STEP1: Create Nano Block to send 150 Nanos to nano_3mh51ybmmedzp99shs7x6ajfcx87sqpp3mt37ohqtz6hccsxh9ufaf3a1stw\n";
$account = 'nano_1ru5kyg89aerkby6fbwndxchk7ksr3de1bafkz1r4k1796pbubjujrypwsdu';
$previous = '7F8E7DFE181544848FCC28CD969CC5539816B49CE17FCA03B7006CFADDA5C687';
$representative = 'nano_3naq5joid48991pxj95tu9z117bghwk3ndum1o4i85jb6gdkerj9rdj6p816';
$balance = '1050.37189';
$balance_type = BALANCE_REAL_STRING;
$value_to_send = '150';
$value_to_send_type = VALUE_SEND_RECEIVE_REAL_STRING;
$destination = 'nano_3mh51ybmmedzp99shs7x6ajfcx87sqpp3mt37ohqtz6hccsxh9ufaf3a1stw';
$direction = VALUE_TO_SEND;
try {
$nano_block = php_c_generate_block(
$account,
$previous,
$representative,
$balance,
$balance_type,
$value_to_send,
$value_to_send_type,
$destination,
$direction
);
} catch (Exception $e) {
echo 'Error code: '.$e->getCode()."\nError message: ".$e->getMessage();
exit(1);
}
echo "SUCCESS: Nano block created. Now adding fee to Nano block ...\n";
$worker_wallet = 'nano_3oj16m1u5h3m9buboxynbwndxyksiy4rjet5cy5nj8fhgjw5h7msrhxud3sz';
$worker_representative = ''; /* if '' then $worker_representative = $representative */
$worker_fee = '0.0001';
$worker_fee_type = WORKER_FEE_REAL; /* worker fee is represented in real value. It could be ommited in this case (real value)*/
try {
$worker_fee_block = php_c_block_to_p2pow(
$nano_block,
$worker_wallet,
$worker_representative,
$worker_fee,
$worker_fee_type
);
} catch (Exception $e) {
echo "Error code in 'php_c_block_to_p2pow' ".$e->getCode()."Error message: ".$e->getMessage();
exit(1);
}
echo "SUCCESS\nP2PoW Fee block =>\n";
echo bin2hex($worker_fee_block);
echo "\nFinally Hello World\n";
?>php create_p2pow_block.phpReturn value (stored in $worker_fee_block variable)
# Binary P2PoW block result representation in Memory (498 Bytes long)
0000000000000000000000000000000000000000000000000000000000000006
6363979c63a198927c46a7945f54f91659c056c0250d97c1814805392c9da63b
7f8e7dfe181544848fcc28cd969cc5539816b49ce17fca03b7006cfadda5c687
d1171c6b0588c7382dd89c7ad9fe00152e7f241a2f730545030e292397266227
00002c644a7b7ee7fb32b5eef2000000
cde3079339b17fb1cf97e4bd2222d574c5cded60cf412d5f7d7c8f52b3d79f6d
00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
00
0000000000000000
0000000000000000000000000000000000000000000000000000000000000006
6363979c63a198927c46a7945f54f91659c056c0250d97c1814805392c9da63b
5452f287f5c1f8fbd70da606050c851127912f9c86b408e39d557c05177b0c49
d1171c6b0588c7382dd89c7ad9fe00152e7f241a2f730545030e292397266227
00002c644a28c7151e6aa91c0e000000
d62024c1b1bc333a769af7d44f28befa59878588b34357874899af7478379679
00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
00
0000000000000000
#Human readable result (JSON Equivalent)
{
"user_transaction": {
"block_type": "state",
"account": "nano_1ru5kyg89aerkby6fbwndxchk7ksr3de1bafkz1r4k1796pbubjujrypwsdu",
"previous": "7F8E7DFE181544848FCC28CD969CC5539816B49CE17FCA03B7006CFADDA5C687",
"representative": "nano_3naq5joid48991pxj95tu9z117bghwk3ndum1o4i85jb6gdkerj9rdj6p816",
"balance": "900371890000000000000000000000000",
"link": "CDE3079339B17FB1CF97E4BD2222D574C5CDED60CF412D5F7D7C8F52B3D79F6D",
"link_as_account": "nano_3mh51ybmmedzp99shs7x6ajfcx87sqpp3mt37ohqtz6hccsxh9ufaf3a1stw",
"signature": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
},
"worker_transaction": {
"block_type": "state",
"account": "nano_1ru5kyg89aerkby6fbwndxchk7ksr3de1bafkz1r4k1796pbubjujrypwsdu",
"previous": "5452F287F5C1F8FBD70DA606050C851127912F9C86B408E39D557C05177B0C49",
"representative": "nano_3naq5joid48991pxj95tu9z117bghwk3ndum1o4i85jb6gdkerj9rdj6p816",
"balance": "900371790000000000000000000000000",
"link": "D62024C1B1BC333A769AF7D44F28BEFA59878588B34357874899AF7478379679",
"link_as_account": "nano_3oj16m1u5h3m9buboxynbwndxyksiy4rjet5cy5nj8fhgjw5h7msrhxud3sz",
"signature": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
}
}
# This block is not signed yet. To sign this block see php_c_sign_p2pow_block()
# To parse P2PoW binary block to JSON see php_c_p2pow_to_json()On error
Throws MyNanoCEmbeddedException
See also
- php_c_p2pow_to_json()
- php_c_generate_block()
- php_c_parse_block_to_json()
- php_c_sign_p2pow_block()
- php_c_p2pow_to_json()
Function [ <internal:mynanoembedded> function php_c_brainwallet_generate ] {
- Parameters [4] {
Parameter #0 [ <required> $brainwallet ]
Parameter #1 [ <required> $salt ]
Parameter #2 [ <required> $mode ]
Parameter #3 [ <optional> $dictionary_path ]
}
}Extract a Nano SEED given a phrase or word list and salt
$res = php_c_brainwallet_generate($brainwallet, $salt, $mode, $dictionary_path);| params | type | description |
|---|---|---|
| $brainwallet | string | Brainwallet text input |
| $salt | string | Salt text input |
| $mode | integer | Brainwallet mode (see table below) to allow only generate custom Nano SEED anti-crack strength |
| $dictionary_path | string | Path and filename to dictionary file *.dic |
| $mode type | description |
|---|---|
| BRAIN_WALLET_VERY_POOR | Allows generate a very poor Brainwallet (Crack within seconds or less) |
| BRAIN_WALLET_POOR | Allows generate a poor Brainwallet (Crack within minutes) |
| BRAIN_WALLET_VERY_BAD | Allows generate a very bad Brainwallet (Crack within one hours) |
| BRAIN_WALLET_BAD | Allows generate a bad Brainwallet (Crack within one day) |
| BRAIN_WALLET_VERY_WEAK | Allows generate a very weak Brainwallet (Crack within one week) |
| BRAIN_WALLET_WEAK | Allows generate a weak Brainwallet (Crack within one year) |
| BRAIN_WALLET_STILL_WEAK | Allows generate a still weak Brainwallet (Crack within one month) |
| BRAIN_WALLET_MAYBE_GOOD | Allows generate a maybe good for you Brainwallet (Crack within one century) |
| BRAIN_WALLET_GOOD | Allows generate a good Brainwallet (Crack within one thousand year) |
| BRAIN_WALLET_VERY_GOOD | Allows generate a very good Brainwallet (Crack within ten thousand year) |
| BRAIN_WALLET_NICE | Allows generate a very nice Brainwallet (Crack withing one hundred thousand year) |
| BRAIN_WALLET_PERFECT | Allows generate a perfect Brainwallet (3.34x10^53 Years to crack) |
Bip39 and Nano SEED extracted from your Brainwallet and Salt in JSON string format
php -r "echo php_c_brainwallet_generate('The state is that great fiction by which everyone tries to live at the expense of everyone else (Fréderic Bastiat 1801-1850)', '[email protected]+phoneNumber:01234567890+AnyOtherTextHere', BRAIN_WALLET_PERFECT,'/var/www/html/dictionary.dic');"Return value
{
"result": {
"seed": "D59BF169DECEF50CE2A61E4850F0D284DD2C7621DE913F214610B14F0FC23522",
"bip39": "stereo test foil rural urban major melody sense embark maple cruise answer spot deposit manual split dish any loud glad valley three stand fork"
},
"warning_msg": "[Perfect!] 3.34x10^53 Years to crack"
}On error
Throws MyNanoCEmbeddedException
Function [ <internal:mynanoembedded> function php_c_calculate_work_from_block ] {
- Parameters [3] {
Parameter #0 [ <required> &$block ]
Parameter #1 [ <required> $number_of_threads ]
Parameter #2 [ <optional> $threshold ]
}
}Calculates a Proof of Work of a Nano Block
php_c_calculate_work_from_block($block, $number_of_threads, $threshold);| params | type | description |
|---|---|---|
| $block | binary | Input Nano block |
| $number_of_threads | integer | Number of CPU threads |
| $threshold | string | (Optional) Threshold value. If ommited then DEFAULT_NANO_POW_THRESHOLD = 0xffffffc000000000 is used |
Binary Nano block with calculated Proof of Work with a custom/default threshold
Create a file "calculate_pow_in_nano_block.php" and type:
<?php
//sat May 23 2020 18:51:17 -03
/*
* EXAMPLE: Prepares a block to receive funds and calculates Proof of Work
* to be stored in Nano Blockchain
*/
echo "STEP1: Create Nano Block to receive (open block) 368.182918 Nanos from nano_3js4zced6abrzy9wiy3q3ozsicszpnfm7oszumrbd9k4yirkhm977n8hbuxy\n";
$account = 'nano_1ru5kyg89aerkby6fbwndxchk7ksr3de1bafkz1r4k1796pbubjujrypwsdu';
$previous = '7F8E7DFE181544848FCC28CD969CC5539816B49CE17FCA03B7006CFADDA5C687';
$representative = 'nano_3naq5joid48991pxj95tu9z117bghwk3ndum1o4i85jb6gdkerj9rdj6p816';
$balance = '0.179';
$balance_type = BALANCE_REAL_STRING;
$value_to_receive = '368.182918';
$value_to_receive_type = VALUE_SEND_RECEIVE_REAL_STRING;
$link = '91FFEBD15E445364AC1BCB4751705A80C7B809B7F02F841F34F33429A4F4A7CC';
$direction = VALUE_TO_RECEIVE;
try {
$nano_block = php_c_generate_block(
$account,
$previous,
$representative,
$balance,
$balance_type,
$value_to_receive,
$value_to_receive_type,
$link,
$direction
);
} catch (Exception $e) {
echo 'Error code: '.$e->getCode()."\nError message: ".$e->getMessage();
exit(1);
}
echo "SUCCESS: Nano block created. Now calculating a Proof of Work. It can take a little longer depending your CPU threads and hardware resources ...\n";
echo "Using default threshold = ".DEFAULT_NANO_POW_THRESHOLD."\n";
$number_of_threads = 4; // 4 Threads !!
try {
php_c_calculate_work_from_block($nano_block, $number_of_threads);
} catch (Exception $e) {
echo "Error code in 'php_c_calculate_work_from_block' ".$e->getCode()."Error message: ".$e->getMessage();
exit(1);
}
echo "SUCCESS\nNano block with calculated Proof of Work =>\n";
echo bin2hex($nano_block);
echo "\nFinally Hello World\n";php calculate_pow_in_nano_block.phpReturn value (stored in $nano_block variable)
# Binary Nano block result representation in Memory (249 Bytes long)
0000000000000000000000000000000000000000000000000000000000000006
6363979c63a198927c46a7945f54f91659c056c0250d97c1814805392c9da63b
7f8e7dfe181544848fcc28cd969cc5539816b49ce17fca03b7006cfadda5c687
d1171c6b0588c7382dd89c7ad9fe00152e7f241a2f730545030e292397266227
00001229618cf8f25cadb2be7e000000
91ffebd15e445364ac1bcb4751705a80c7b809b7f02f841f34f33429a4f4a7cc
00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
00
4ad6c2753a3886b1
#Human readable result (JSON Equivalent)
{
"action": "process",
"json_block": "true",
"block": {
"type": "state",
"account": "nano_1ru5kyg89aerkby6fbwndxchk7ksr3de1bafkz1r4k1796pbubjujrypwsdu",
"previous": "7F8E7DFE181544848FCC28CD969CC5539816B49CE17FCA03B7006CFADDA5C687",
"representative": "nano_3naq5joid48991pxj95tu9z117bghwk3ndum1o4i85jb6gdkerj9rdj6p816",
"balance": "368361918000000000000000000000000",
"link": "91FFEBD15E445364AC1BCB4751705A80C7B809B7F02F841F34F33429A4F4A7CC",
"link_as_account": "nano_36hzxhaowj4mekp3qkt9c7r7o189q16uhw3hiihmbwsn78khbbyeyygafis4",
"signature": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"work": "B186383A75C2D64A"
}
}
# This block is not signed yet. To sign this block see php_c_sign_block()
# To parse Nano binary block to JSON see php_c_parse_block_to_json()On error
Throws MyNanoCEmbeddedException
See also
- php_c_sign_block()
- php_c_parse_block_to_json()
Function [ <internal:mynanoembedded> function php_c_compare ] {
- Parameters [4] {
Parameter #0 [ <required> $valueA ]
Parameter #1 [ <required> $valueB ]
Parameter #2 [ <required> $type ]
Parameter #3 [ <required> $compare ]
}
}Compares two Nano big numbers values
php_c_compare($valueA, $valueB, $type, $compare);| params | type | description |
|---|---|---|
| $valueA | string | Input Nano value A |
| $valueB | string | Input Nano value B |
| $type | integer | Input big numbers type |
| $compare | integer | Nano Big number condition |
| $type type | description |
|---|---|
| NANO_A_REAL_STRING | Input value A $valueA is real value |
| NANO_A_RAW_STRING | Input value A $valueA is Nano raw string |
| NANO_A_RAW_128 | Input vallue A $valueA is Raw big number |
| NANO_B_REAL_STRING | Input value B $valueB is real value |
| NANO_B_RAW_STRING | Input value B $valueB is Nano raw string |
| NANO_B_RAW_128 | Input value B $valueB is Raw big number |
| $compare type | description |
|---|---|
| NANO_COMPARE_EQ | Value A $valueA is EQUAL Value B $valueB |
| NANO_COMPARE_LT | Value A $valueA is LESSER THAN Value B $valueB |
| NANO_COMPARE_LEQ | Value A $valueA is LESSER THAN OR EQUAL Value B $valueB |
| NANO_COMPARE_GT | Value A $valueA is GREATER THAN Value B $valueB |
| NANO_COMPARE_GEQ | Value A $valueA is GREATER THAN OR EQUAL Value B $valueB |
Rerurns true if condition comapare satisfies expression else returns false
php -r "echo (php_c_compare('2.1', '3', NANO_A_REAL_STRING|NANO_B_REAL_STRING, NANO_COMPARE_GT))?'TRUE':'FALSE';"
# 2.1 > 3 RETURNS FALSEphp -r "echo (php_c_compare('72', '3', NANO_A_REAL_STRING|NANO_B_REAL_STRING, NANO_COMPARE_GT))?'TRUE':'FALSE';"
# 72 > 3 RETURNS TRUEphp -r "echo (php_c_compare('5.9', '791789901910919928837771776677', NANO_A_REAL_STRING|NANO_B_RAW_STRING, NANO_COMPARE_LEQ))?'TRUE':'FALSE';"
# 5.9(REAL) <= 791789901910919928837771776677(RAW) RETURNS FALSE
# Human readable result
# 5.9 <= 0.791789901910919928837771776677 RETURNS FALSEphp -r "echo (php_c_compare('30298174000000000000000000000000', '0000017E6AAE20E930F871DCFE000000', NANO_A_RAW_STRING|NANO_B_RAW_128, NANO_COMPARE_EQ))?'TRUE':'FALSE';"
# 30298174000000000000000000000000(RAW) == 0000017E6AAE20E930F871DCFE000000(HEX) RETURNS TRUE
# Human readable result
# 30.298174 == 30.298174 RETURNS TRUEOn error
Throws MyNanoCEmbeddedException
Function [ <internal:mynanoembedded> function php_c_convert_balance ] {
- Parameters [2] {
Parameter #0 [ <required> $balance ]
Parameter #1 [ <required> $type ]
}
}Converts one Nano balance to another
php_c_convert_balance($balance, $type);| params | type | description |
|---|---|---|
| $balance | string | Input Nano balance |
| $type | integer | type of the balance |
| $type type | description |
|---|---|
| REAL_TO_RAW | Converts a real value to raw value |
| RAW_TO_REAL | Converts a raw value to real value |
| REAL_TO_HEX | Converts real value to hex value |
| HEX_TO_REAL | Converts hex value to real value |
| RAW_TO_HEX | Converts a raw value to hex value |
| HEX_TO_RAW | Converts a hex value to raw value |
Rerurns a string with converted value
php -r "echo php_c_convert_balance('3.6791098001', REAL_TO_RAW);"
# RETURNS 3679109800100000000000000000000(RAW)php -r "echo php_c_convert_balance('102986792098301000000000000000000', RAW_TO_REAL);"
# RETURNS 102.986792098301(REAL)php -r "echo php_c_convert_balance('102387.1871001928376', REAL_TO_HEX);"
# RETURNS 0013b813fc4f1e74792ef7068f300000(HEX)php -r "echo php_c_convert_balance('00231b73b099bd5f7da44a8163040000', HEX_TO_REAL);"
# RETURNS 182287.181001928370216(REAL)php -r "echo php_c_convert_balance('198282281933192837221600000000000000', RAW_TO_HEX);"
# RETURNS 002630123F23E91C00F3147CD12E0000(HEX)php -r "echo php_c_convert_balance('08d7b616e531cbcf6cd3657e5ba7634a', HEX_TO_RAW);"
# RETURNS 11753861003364021922160004983677215562(RAW)On error
Throws MyNanoCEmbeddedException
Function [ <internal:mynanoembedded> function php_c_from_multiplier ] {
- Parameters [2] {
Parameter #0 [ <required> $multiplier ]
Parameter #1 [ <required> $base_difficulty ]
}
}Takes a multiplier and converts to Nano Proof of Work difficulty
php_c_from_multiplier($multiplier, $base_difficulty);| params | type | description |
|---|---|---|
| $multiplier | double | Double value of the multiplier |
| $base_difficulty | string | String value in Hex or Octal or Decimal value |
Rerurns a hex string value
php -r "echo php_c_from_multiplier(4, DEFAULT_NANO_POW_THRESHOLD);"
# RETURNS 0xfffffff000000000php -r "echo php_c_from_multiplier(5.671, '0xfffff10000000000');"
# RETURNS 0xfffffd5adee9340dphp -r "echo php_c_from_multiplier(3.23, '0612791712736716625');"
# RETURNS 0xb0be377ad92a0800
# 0612791882736716625 // Octal valuephp -r "echo php_c_from_multiplier(4.891, '8212791982736716625');"
# RETURNS 0xe2f648e16fa3c600
# 8212791982736716625 // Decimal valueOn error
Throws MyNanoCEmbeddedException
See also
- php_c_to_multiplier()
Function [ <internal:mynanoembedded> function php_c_gen_encrypted_stream_to_seed ] {
- Parameters [3] {
Parameter #0 [ <required> $encrypted_stream ]
Parameter #1 [ <required> $password ]
Parameter #2 [ <required> $dictionary_file ]
}
}Takes a encrypted stream and extract a Nano SEED given a password
php_c_gen_encrypted_stream_to_seed($encrypted_stream, $password, $dictionary_file);| params | type | description |
|---|---|---|
| $encrypted_stream | binary | Encrypted binary block that stores one Nano SEED |
| $password | string | Password to decrypt block and extract the Nano SEED |
| $dictionary_file | string | File and path of dictionary file *.dic |
Rerurns a hex string with Nano SEED
Assuming dictionary file is located in '/var/www/html/dictionary.dic' create a file decrypt_block.php and type:
<?php
//sun May 24 2020 22:52 -03
/*
* EXAMPLE: Creates an encrypted block containing a generated random Nano SEED
* and extracts its Nano SEED and Bip39
*/
echo "STEP1: Creates a Nano SEED with a highest entropy level with password '%1kmLaP,xKwI8)17&&61b>ç~1'\n";
$entropy = ENTROPY_TYPE_PARANOIC; // Highest security level. Very slow but the best safest way to generate your random Nano SEED
$password = '%1\kmLaP,/xKwI8)17&&61b>ç|hy[~1'; // Ohhhh. What a strong password !!!
$password_min_len = 15; // Minimum acceptable length of the password
$password_max_len = 64; // Maximum acceptable length of the password
$password_type = PASS_MUST_HAVE_AT_LEAST_ONE_NUMBER|PASS_MUST_HAVE_AT_LEAST_ONE_SYMBOL| // Recommended password requirements
PASS_MUST_HAVE_AT_LEAST_ONE_UPPER_CASE|PASS_MUST_HAVE_AT_LEAST_ONE_LOWER_CASE;
echo "Generating a Nano SEED and encrypting in a non deterministic key with password '".$password."'.\nIt can take a little longer\n";
echo "Move the mouse, open programs to increase entropy to generate the Nano SEED...\n";
try {
$encrypted_nano_seed = php_c_gen_seed_to_encrypted_stream(
$entropy,
$password,
$password_min_len,
$password_max_len,
$password_type
);
} catch (Exception $e) {
echo 'Error code: '.$e->getCode()."\nError message: ".$e->getMessage();
exit(1);
}
echo "SUCCESS: Nano SEED generated successfully. Now decrypting and extracting with password '".$password."'...\n";
echo "STEP 2:\n";
$dictionary_path = '/var/www/html/dictionary.dic'; // Path to dictionary
try {
$encrypted_nano_seed = php_c_gen_encrypted_stream_to_seed($encrypted_nano_seed, $password, $dictionary_path);
} catch (Exception $e) {
echo "Error code in 'php_c_gen_encrypted_stream_to_seed' ".$e->getCode()." Error message: ".$e->getMessage();
exit(1);
}
echo "SUCCESS\nUnencrypted Nano SEED =>\n";
echo $encrypted_nano_seed;
echo "\nFinally Hello World\n";
?>php decrypt_block.php# Encrypted NANO SEED in memory in binary block (352 Bytes long)
# ----------------------------------------------------------------
# 5f6e616e6f77616c6c657466696c655f000001004e414e4f205365656420456e
# 637279707465642066696c652f73747265616d2e204b65657020697420736166
# 6520616e64206261636b75702069742e20546869732066696c65206973207072
# 6f7465637465642062792070617373776f72642e2042555920424954434f494e
# 20616e64204e414e4f2021212100e0e1f2aeef6b77d3ba76f6bd477b47fe7681
# a3d9094badddcb5d19560fa20d8dbc925b57b5f4d804a663bad48557cc451827
# 5f0106690ad8a88c04bd2848c4cb2df0819cbc094566b0f9fbeb3f34a2ada355
# 006df20a2c5f79af9b5ef420d1af961d1905b086a91e58cc9ce4dc88ebdcc0e3
# 91154acd33b1afe2592216ce2526c4dd1a1aa798e94c614f5f9fdb6bbadea470
# 88565665cccdcf566c5027dac81407bff193599bcaf24633145f8aaa02c12020
# 75a6a940999d98b5a15c2e12303519b9709e6b718f6683d9dc4e98e0bba67bfa
# RETURNS
STEP1: Creates a Nano SEED with a highest entropy level with password '%1kmLaP,xKwI8)17&&61b>ç~1'
Generating a Nano SEED and encrypting in a non deterministic key with password '%1\kmLaP,/xKwI8)17&&61b>ç|hy[~1'.
It can take a little longer
Move the mouse, open programs to increase entropy to generate the Nano SEED...
SUCCESS: Nano SEED generated successfully. Now decrypting and extracting with password '%1\kmLaP,/xKwI8)17&&61b>ç|hy[~1'...
STEP 2:
SUCCESS
Unencrypted Nano SEED =>
{
"seed":"BDFBD45F2EA1F82E972FF7548A7C8B5CEBDE7CB1C04ADD5265DD94B1CA58B459",
"bip39":"sadness team blind front buzz blanket frequent year fee fault carpet right sadness dinner shove announce tail nasty jazz city bronze clump sphere dish"
}
Finally Hello World
On error
Throws MyNanoCEmbeddedException
See also
- php_c_gen_seed_to_encrypted_stream()
Function [ <internal:mynanoembedded> function php_c_gen_seed_to_encrypted_stream ] {
- Parameters [5] {
Parameter #0 [ <required> $entropy ]
Parameter #1 [ <required> $password ]
Parameter #2 [ <required> $password_min_len ]
Parameter #3 [ <required> $password_max_len ]
Parameter #4 [ <optional> $password_type ]
}
}This function has two functionalities
- Creates a Nano SEED using TRNG Hardware (if available) or PRNG with desired entropy level and encrypt Nano SEED with a given formatted password with non deterministic cryptography
- Save your NANO SEED and encrypt with a given formatted password with non deterministic cryptography
$res = php_c_gen_seed_to_encrypted_stream($entropy, $password, $password_min_len, $password_max_len, $password_type);| params | type | description |
|---|---|---|
| $entropy | integer or string | Entropy type (see below) or your NANO SEED |
| $password | string | Password to encrypt the random generated Nano SEED |
| $password_min_len | integer | Minimum allowed password length |
| $password_max_len | integer | Maximum allowed password length |
| $password_type | integer | Password allowed type (see below) |
| $entropy type | description |
|---|---|
| ENTROPY_TYPE_PARANOIC | Paranoic entropy type. Very slow. Strongly recommended to create SEED's |
| ENTROPY_TYPE_EXCELENT | Excelent entropy tyoe. Slow. Recommended to create SEED's |
| ENTROPY_TYPE_GOOD | Good entropy type. Normal. Standard type to create SEED's |
| ENTROPY_TYPE_NOT_ENOUGH | Not enough. Fast. Not recommended for creating SEED's |
| ENTROPY_TYPE_NOT_RECOMENDED | Not recommended. Very fast. Try not to use this option. Recommended only to generate temporary SEED's |
| $password_type type | description |
|---|---|
| PASS_MUST_HAVE_AT_LEAST_NONE | Password don't need any special characters |
| PASS_MUST_HAVE_AT_LEAST_ONE_NUMBER | Password must have at least one number |
| PASS_MUST_HAVE_AT_LEAST_ONE_SYMBOL | Password must have at least one symbol |
| PASS_MUST_HAVE_AT_LEAST_ONE_UPPER_CASE | Password must have at least one upper case |
| PASS_MUST_HAVE_AT_LEAST_ONE_LOWER_CASE | Password must have at least one lower case |
Encrypted block of Nano SEED in memory
Create a file encrypt_block.php and type:
<?php
//sun May 24 2020 22:52 -03
/*
* EXAMPLE: Creates an encrypted block in memory containing a generated random Nano SEED
*/
echo "Creates a Nano SEED with a highest entropy level with password '%1kmLaP,xKwI8)17&&61b>ç~1'\n";
$entropy = ENTROPY_TYPE_PARANOIC; // Highest security level. Very slow but the best safest way to generate your random Nano SEED
$password = '%1\kmLaP,/xKwI8)17&&61b>ç|hy[~1'; // Ohhhh. What a strong password !!!
$password_min_len = 15; // Minimum acceptable length of the password
$password_max_len = 64; // Maximum acceptable length of the password
$password_type = PASS_MUST_HAVE_AT_LEAST_ONE_NUMBER|PASS_MUST_HAVE_AT_LEAST_ONE_SYMBOL| // Recommended password requirements
PASS_MUST_HAVE_AT_LEAST_ONE_UPPER_CASE|PASS_MUST_HAVE_AT_LEAST_ONE_LOWER_CASE;
echo "Generating a Nano SEED and encrypting in a non deterministic key with password '".$password."'.\nIt can take a little longer\n";
echo "Move the mouse, open programs to increase entropy to generate the Nano SEED...\n";
try {
$encrypted_nano_seed = php_c_gen_seed_to_encrypted_stream(
$entropy,
$password,
$password_min_len,
$password_max_len,
$password_type
);
} catch (Exception $e) {
echo 'Error code: '.$e->getCode()."\nError message: ".$e->getMessage();
exit(1);
}
echo "SUCCESS: Nano SEED generated and encrypted successfully in memory.";
?>php decrypt_block.phpReturn value
Creates a Nano SEED with a highest entropy level with password '%1kmLaP,xKwI8)17&&61b>ç~1'
Generating a Nano SEED and encrypting in a non deterministic key with password '%1\kmLaP,/xKwI8)17&&61b>ç|hy[~1'.
It can take a little longer
Move the mouse, open programs to increase entropy to generate the Nano SEED...
SUCCESS: Nano SEED generated and encrypted successfully in memory
# Encrypted NANO SEED in memory in binary block (352 Bytes long)
# ----------------------------------------------------------------
# 5f6e616e6f77616c6c657466696c655f000001004e414e4f205365656420456e
# 637279707465642066696c652f73747265616d2e204b65657020697420736166
# 6520616e64206261636b75702069742e20546869732066696c65206973207072
# 6f7465637465642062792070617373776f72642e2042555920424954434f494e
# 20616e64204e414e4f2021212100e0e1f2aeef6b77d3ba76f6bd477b47fe7681
# a3d9094badddcb5d19560fa20d8dbc925b57b5f4d804a663bad48557cc451827
# 5f0106690ad8a88c04bd2848c4cb2df0819cbc094566b0f9fbeb3f34a2ada355
# 006df20a2c5f79af9b5ef420d1af961d1905b086a91e58cc9ce4dc88ebdcc0e3
# 91154acd33b1afe2592216ce2526c4dd1a1aa798e94c614f5f9fdb6bbadea470
# 88565665cccdcf566c5027dac81407bff193599bcaf24633145f8aaa02c12020
# 75a6a940999d98b5a15c2e12303519b9709e6b718f6683d9dc4e98e0bba67bfaSaving and ecrypting your example Nano SEED = "3E4EAC9A2CA907F6CA48C3F9F2FD09F3C37F2891555A5F24FC0318A9317D2B65" with password=MyPasswordHere1234@5678
php -r "echo bin2hex(php_c_gen_seed_to_encrypted_stream('3E4EAC9A2CA907F6CA48C3F9F2FD09F3C37F2891555A5F24FC0318A9317D2B65', 'MyPasswordHere1234@5678', 15, 65, (PASS_MUST_HAVE_AT_LEAST_ONE_NUMBER|PASS_MUST_HAVE_AT_LEAST_ONE_SYMBOL|PASS_MUST_HAVE_AT_LEAST_ONE_UPPER_CASE|PASS_MUST_HAVE_AT_LEAST_ONE_LOWER_CASE)));"Return value
5f6e616e6f77616c6c657466696c655f000001004e414e4f205365656420456e
637279707465642066696c652f73747265616d2e204b65657020697420736166
6520616e64206261636b75702069742e20546869732066696c65206973207072
6f7465637465642062792070617373776f72642e2042555920424954434f494e
20616e64204e414e4f2021212100f5cd704691168f67bea9ef815a35edc7ea7b
a69a654f2d3bbb4dccc006642dcb5bee435754c5446678fd5493dc449ebb794b
4616dd9f055fb5c4f190cc8f37e72d8b3921d2c06b5130956715b52e5e47dbb4
082696821149df4d32506497f015b5da8ededf28143b422e2913b5b285189ff6
2f7808622f5c29861ecef08fd324f8939e077945bad50fa812a10a5ece5c696c
28c2072227f24f168b06d21f0ab105c36787dc03894880036c61a6079442625f
a3e236862b53c0bc41538d499275783a733325ae2e1f7548e952adce20d8723eExample 3 (Saving and encrypting your NANO Seed in block with the same Nano SEED and password in example 2);
Saving and ecrypting your example Nano SEED = "3E4EAC9A2CA907F6CA48C3F9F2FD09F3C37F2891555A5F24FC0318A9317D2B65" with password=MyPasswordHere1234@5678
php -r "echo bin2hex(php_c_gen_seed_to_encrypted_stream('3E4EAC9A2CA907F6CA48C3F9F2FD09F3C37F2891555A5F24FC0318A9317D2B65', 'MyPasswordHere1234@5678', 15, 65, (PASS_MUST_HAVE_AT_LEAST_ONE_NUMBER|PASS_MUST_HAVE_AT_LEAST_ONE_SYMBOL|PASS_MUST_HAVE_AT_LEAST_ONE_UPPER_CASE|PASS_MUST_HAVE_AT_LEAST_ONE_LOWER_CASE)));"Return value
5f6e616e6f77616c6c657466696c655f000001004e414e4f205365656420456e
637279707465642066696c652f73747265616d2e204b65657020697420736166
6520616e64206261636b75702069742e20546869732066696c65206973207072
6f7465637465642062792070617373776f72642e2042555920424954434f494e
20616e64204e414e4f2021212100b38389db347bd67df6041ca05ffc564b5712
654eea7a0b094364aef2721bda4a2239f300b0130013638491a02ebb1a771d75
bfa8c050132e69ae057c7d82349c2c4ded4ecd57b30bde25d63fce8b6f53edf1
a785035a330c21963253fc2c007fde25fb0318bb2ca2fb63394b47e2f415d6ce
d50b7254d5b6d1d34b46f40a403c4f73e40b78fe74222de10aa12eff8e872595
66f0bd7e5add023ecd2eff126dd412367e7493b1565fb660c132a578abc71d39
5e206d93db181d4d3ea00ccd5bd4df6ebc7e253e67f004de1192c0518cc0d2daNOTICE: Although you are using the same Nano SEED and the same password in example 2 and 3, encrypted block are DIFFERENTS. And both are valid and can be decrypted with php_c_gen_encrypted_stream_to_seed()
On error
Throws MyNanoCEmbeddedException
See also
- php_c_gen_encrypted_stream_to_seed()
Function [ <internal:mynanoembedded> function php_c_generate_block ] {
- Parameters [9] {
Parameter #0 [ <required> $account ]
Parameter #1 [ <required> $previous ]
Parameter #2 [ <required> $representative ]
Parameter #3 [ <required> $balance ]
Parameter #4 [ <required> $balance_type ]
Parameter #5 [ <required> $val_send_rec ]
Parameter #6 [ <required> $val_send_rec_type ]
Parameter #7 [ <required> $link ]
Parameter #8 [ <required> $direction ]
}
}Generates a Nano Block to be stored in Nano Blockchain
$res = php_c_generate_block(
$account,
$previous,
$representative,
$balance,
$balance_type,
$val_send_rec,
$val_send_rec_type,
$link,
$direction
);| params | type | description |
|---|---|---|
| $account | string | Nano wallet or public key |
| $previous | string | Previous block |
| $representative | sring | Representative wallet or representative public key |
| $balance | string | Nano big number balance |
| $balance_type | integer | Nano big number type (see table below) |
| $val_send_rec | string | Value to send/receive |
| $val_send_rec_type | integer | Value to send/receive type (see table below) |
| $link | Destination wallet or destination public key or link | |
| $direction | integer | Send or receive (see table below) |
| $balance_type type | description |
|---|---|
| BALANCE_REAL_STRING | Input $balance is big number real string |
| BALANCE_RAW_STRING | Input $balance is big number raw string |
| BALANCE_RAW_128 | Input $balance is big number hex string |
| $val_send_rec_type type | description |
|---|---|
| VALUE_SEND_RECEIVE_REAL_STRING | Input $val_send_rec_type is big number real string |
| VALUE_SEND_RECEIVE_RAW_STRING | Input $val_send_rec_type is big number raw string |
| VALUE_SEND_RECEIVE_RAW_128 | Input $val_send_rec_type is big number hex string |
| $direction type | description |
|---|---|
| VALUE_TO_SEND | Value to send |
| VALUE_TO_RECEIVE | Value to receive (open block) |
Binary Nano block in memory variable.
Create a file create_block_ex1.php and type:
<?php
//mon May 25 2020 17:58 -03
/*
* EXAMPLE: Prepares a block to receive funds (400 nanos) from nano_3js4zced6abrzy9wiy3q3ozsicszpnfm7oszumrbd9k4yirkhm977n8hbuxy
*/
echo "Create Nano Block to receive (open block) 400.0 Nanos from nano_3js4zced6abrzy9wiy3q3ozsicszpnfm7oszumrbd9k4yirkhm977n8hbuxy\n";
$account = 'nano_1ru5kyg89aerkby6fbwndxchk7ksr3de1bafkz1r4k1796pbubjujrypwsdu';
$previous = '7F8E7DFE181544848FCC28CD969CC5539816B49CE17FCA03B7006CFADDA5C687';
$representative = 'nano_3naq5joid48991pxj95tu9z117bghwk3ndum1o4i85jb6gdkerj9rdj6p816';
$balance = '0.179';
$balance_type = BALANCE_REAL_STRING;
$value_to_receive = '400.0';
$value_to_receive_type = VALUE_SEND_RECEIVE_REAL_STRING;
$link = 'C722FA98B22138FF8FC878370D7F982B3FB51B32D73FDCF0959E42F43127CCE5';
$direction = VALUE_TO_RECEIVE;
try {
$nano_block = php_c_generate_block(
$account,
$previous,
$representative,
$balance,
$balance_type,
$value_to_receive,
$value_to_receive_type,
$link,
$direction
);
} catch (Exception $e) {
echo 'Error code: '.$e->getCode()."\nError message: ".$e->getMessage();
exit(1);
}
echo "Successfully block stored in memory in \$nano_block variable\n";
?>php create_block_ex1.phpReturn value
Create Nano Block to receive (open block) 400.0 Nanos from nano_3js4zced6abrzy9wiy3q3ozsicszpnfm7oszumrbd9k4yirkhm977n8hbuxy
Successfully block stored in memory in $nano_block variable
# Binary Nano block result representation in Memory (249 Bytes long)
0000000000000000000000000000000000000000000000000000000000000006
6363979c63a198927c46a7945f54f91659c056c0250d97c1814805392c9da63b
7f8e7dfe181544848fcc28cd969cc5539816b49ce17fca03b7006cfadda5c687
d1171c6b0588c7382dd89c7ad9fe00152e7f241a2f730545030e292397266227
000013baf81659d1d57d689a38000000
c722fa98b22138ff8fc878370d7f982b3fb51b32d73fdcf0959e42f43127cce5
00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
00
0000000000000000
#Human readable result (JSON Equivalent)
{
"action": "process",
"json_block": "true",
"block": {
"type": "state",
"account": "nano_1ru5kyg89aerkby6fbwndxchk7ksr3de1bafkz1r4k1796pbubjujrypwsdu",
"previous": "7F8E7DFE181544848FCC28CD969CC5539816B49CE17FCA03B7006CFADDA5C687",
"representative": "nano_3naq5joid48991pxj95tu9z117bghwk3ndum1o4i85jb6gdkerj9rdj6p816",
"balance": "400179000000000000000000000000000",
"link": "C722FA98B22138FF8FC878370D7F982B3FB51B32D73FDCF0959E42F43127CCE5",
"link_as_account": "nano_3js4zced6abrzy9wiy3q3ozsicszpnfm7oszumrbd9k4yirkhm977n8hbuxy",
"signature": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"work": "0000000000000000"
}
}Create a file create_block_ex2.php and type:
<?php
//mon May 25 2020 17:58 -03
/*
* EXAMPLE 2: Prepares a block to open block with 1 Nano (1000000000000000000000000000000) RAW
* from link 3673BE411A67C4F5906AB345D01DEC5F0034CF54A3BFE706E934FD724B181DCF
*/
echo "Create Nano Block to receive (open block) 1 Nano from link 3673BE411A67C4F5906AB345D01DEC5F0034CF54A3BFE706E934FD724B181DCF\n";
$account = 'nano_1kzzdbp44ii5dxe89gqefgqg1ijjb5ced9cywktae77ikj9fs18xqktjmqju';
$previous = '7F8E7DFE181544848FCC28CD969CC5539816B49CE17FCA03B7006CFADDA5C687';
$representative = 'xrb_1cuenosfguwpot55eabwdeh8r3e3esdao8m6hb9ya3kyr38e9n5jo3qun8om';
$balance = '300';
$balance_type = BALANCE_REAL_STRING;
$value_to_receive = '1000000000000000000000000000000';
$value_to_receive_type = VALUE_SEND_RECEIVE_RAW_STRING;
$link = '3673BE411A67C4F5906AB345D01DEC5F0034CF54A3BFE706E934FD724B181DCF';
$direction = VALUE_TO_RECEIVE;
try {
$nano_block = php_c_generate_block(
$account,
$previous,
$representative,
$balance,
$balance_type,
$value_to_receive,
$value_to_receive_type,
$link,
$direction
);
} catch (Exception $e) {
echo 'Error code: '.$e->getCode()."\nError message: ".$e->getMessage();
exit(1);
}
echo "Successfully block stored in memory in \$nano_block variable\n";
?>php create_block_ex2.phpReturn value
Create Nano Block to receive (open block) 1 Nano from link 3673BE411A67C4F5906AB345D01DEC5F0034CF54A3BFE706E934FD724B181DCF
Successfully block stored in memory in $nano_block variable
# Binary Nano block result representation in Memory (249 Bytes long)
0000000000000000000000000000000000000000000000000000000000000006
4bff5a6c2142035f5863baec6baee0423148d4c59d5ee4b48614b0944edc80dd
7f8e7dfe181544848fcc28cd969cc5539816b49ce17fca03b7006cfadda5c687
2b6ca572d76f96ae8636213c5b1e6c058166568a9a647a4fe4065ec04cc3d071
00000ed7277460e2d77bbc6d40000000
3673be411a67c4f5906ab345d01dec5f0034cf54a3bfe706e934fd724b181dcf
00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
04
0000000000000000
#Human readable result (JSON Equivalent)
{
"action": "process",
"json_block": "true",
"block": {
"type": "state",
"account": "nano_1kzzdbp44ii5dxe89gqefgqg1ijjb5ced9cywktae77ikj9fs18xqktjmqju",
"previous": "7F8E7DFE181544848FCC28CD969CC5539816B49CE17FCA03B7006CFADDA5C687",
"representative": "xrb_1cuenosfguwpot55eabwdeh8r3e3esdao8m6hb9ya3kyr38e9n5jo3qun8om",
"balance": "301000000000000000000000000000000",
"link": "3673BE411A67C4F5906AB345D01DEC5F0034CF54A3BFE706E934FD724B181DCF",
"link_as_account": "nano_1fmmqs1jnsy6ypa8oet7t1gyrqr18m9obaxzww5gkf9xgb7ji9ghu1tr9th7",
"signature": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"work": "0000000000000000"
}
}Create a file create_block_ex3.php and type:
<?php
//mon May 25 2020 17:58 -03
/*
* EXAMPLE 3: Prepares a block to open first block (receive 10 Nanos) from link 2A825E929A29ED9F2763ACF3DCB0855BFE6A4C58E59F99AC8F596810FACAD283
*/
echo "Create Nano Block to receive (open first block) 10 Nanos from link 2A825E929A29ED9F2763ACF3DCB0855BFE6A4C58E59F99AC8F596810FACAD283\n";
$account = 'nano_3d15845cjkqczun3k1379xwhgzdz5taj74j9zbbwaegg4okebkf6jfdppdku';
$previous = ''; // Empty string means first block
$representative = 'nano_1t675o8bsremxwn57di69f1qxrkjab51e383o51469ao1ktbeht6nyjd611h';
$balance = '0';
$balance_type = BALANCE_REAL_STRING;
$value_to_receive = '10';
$value_to_receive_type = VALUE_SEND_RECEIVE_REAL_STRING;
$link = '2A825E929A29ED9F2763ACF3DCB0855BFE6A4C58E59F99AC8F596810FACAD283';
$direction = VALUE_TO_RECEIVE;
try {
$nano_block = php_c_generate_block(
$account,
$previous,
$representative,
$balance,
$balance_type,
$value_to_receive,
$value_to_receive_type,
$link,
$direction
);
} catch (Exception $e) {
echo 'Error code: '.$e->getCode()."\nError message: ".$e->getMessage();
exit(1);
}
echo "Successfully block stored in memory in \$nano_block variable\n";
?>php create_block_ex3.phpReturn value
Create Nano Block to receive (open first block) 10 Nanos from link 2A825E929A29ED9F2763ACF3DCB0855BFE6A4C58E59F99AC8F596810FACAD283
Successfully block stored in memory in $nano_block variable
# Binary Nano block result representation in Memory (249 Bytes long)
0000000000000000000000000000000000000000000000000000000000000006
ac033086a8caeafee81900253f78f77d7f1e91128a27fa53c431ce1564c4c9a4
0000000000000000000000000000000000000000000000000000000000000000
68851d4c9ce193ef2832ae043b417ee25142460604c1a8c0221d1504b4963f44
0000007e37be2022c0914b2680000000
2a825e929a29ed9f2763acf3dcb0855bfe6a4c58e59f99ac8f596810facad283
00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
00
0000000000000000
#Human readable result (JSON Equivalent)
{
"action": "process",
"json_block": "true",
"block": {
"type": "state",
"account": "nano_3d15845cjkqczun3k1379xwhgzdz5taj74j9zbbwaegg4okebkf6jfdppdku",
"previous": "0000000000000000000000000000000000000000000000000000000000000000",
"representative": "nano_1t675o8bsremxwn57di69f1qxrkjab51e383o51469ao1ktbeht6nyjd611h",
"balance": "10000000000000000000000000000000",
"link": "2A825E929A29ED9F2763ACF3DCB0855BFE6A4C58E59F99AC8F596810FACAD283",
"link_as_account": "nano_1cn4dtbbnchfmwmp9d9mukracpzyfb87jsezm8paypda45xeonn5afyr8oru",
"signature": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"work": "0000000000000000"
}
}On error
Throws MyNanoCEmbeddedException
See also
- php_c_parse_block_to_json()
Function [ <internal:mynanoembedded> function php_c_generate_seed ] {
- Parameters [1] {
Parameter #0 [ <required> $entropy ]
}
}Geneartes a random seed using hardware TRNG (if available) or PRNG and genarates a random Nano SEED
$res = php_c_generate_seed($entropy);| params | type | description |
|---|---|---|
| $entropy | integer | Entropy type (see below) |
| $entropy type | description |
|---|---|
| ENTROPY_TYPE_PARANOIC | Paranoic entropy type. Very slow. Strongly recommended to create SEED's |
| ENTROPY_TYPE_EXCELENT | Excelent entropy tyoe. Slow. Recommended to create SEED's |
| ENTROPY_TYPE_GOOD | Good entropy type. Normal. Standard type to create SEED's |
| ENTROPY_TYPE_NOT_ENOUGH | Not enough. Fast. Not recommended for creating SEED's |
| ENTROPY_TYPE_NOT_RECOMENDED | Not recommended. Very fast. Try not to use this option. Recommended only to generate temporary SEED's |
Nano SEED encoded hex string
php -r "echo php_c_generate_seed(ENTROPY_TYPE_PARANOIC);"Return value
# RETURN VALUE
52A90664B8C463BD20ECCDDE96FAADE8E95CEB3F4E5978E6A5E74B4E00478F4AOn error
Throws MyNanoCEmbeddedException
Function [ <internal:mynanoembedded> function php_c_generate_token ] {
- Parameters [2] {
Parameter #0 [ <required> $data ]
Parameter #1 [ <required> $password ]
}
}Generates a 16 bytes with non deterministic hash token
$res = php_c_generate_token($data, $password);| params | type | description |
|---|---|---|
| $data | string | Data do be assigned |
| $password | string | Password to define non deterministic hash |
Token encoded in hex string
Hash string "Hello World" with password "MyPassword@1234"
php -r "echo php_c_generate_token('Hello World', 'MyPassword@1234');"Return value
# RETURN VALUE
c70576a2e31d0b6e071d7352c4a43b5fHash string "Hello World" with password "MyPassword@1234" (Again)
php -r "echo php_c_generate_token('Hello World', 'MyPassword@1234');"Return value
# RETURN VALUE
f87a96e215e0a3c56f7f0969288956cdPassword and data are the same but hash are different and both are valid
On error
Throws MyNanoCEmbeddedException
See also
php_c_verify_token()
Function [ <internal:mynanoembedded> function php_c_get_account_from_block ] {
- Parameters [3] {
Parameter #0 [ <required> $block ]
Parameter #1 [ <optional> $type ]
Parameter #2 [ <optional> $prefix ]
}
}Extracts account with encoded Nano Base32 string or public key hex string
$res = php_c_get_account_from_block($block, $type, $prefix);| params | type | description |
|---|---|---|
| $block | binary | Binary Nano block |
| $type | integer | Type 0 for wallet address (with nano_ or xrb_ prefixes) or 1 for hex string (public key) |
| $prefix | string | (Optional) If ommited, then prefix will be NANO_PREFIX prefix when type is 0. Choose NANO_PREFIX or XRB_PREFIX prefixes |
Extracted Nano wallet with encoded Base32 or hex string public key
<?php
/*
Assuming Nano block below is in $block variable
0000000000000000000000000000000000000000000000000000000000000006
918105963ce5d61ad9d74d294164fac36a077b5e2b53d219e619d5ee3e64e1b0
f9252d13ec4103ccc6b1f1712c617413adc741d16a465452ca90c504d9f2c278
22f2c23d07f7eb43ebdb470e35493ebbadfdc447bd4b983623703767728974b6
000000000052b7d2dcc80cd2e4000000
f9640ff8804a3720efc9d2a190cdcac87011b6eb2bff9bcda6e15400ec76d8b0
d6a78e49f87bb5e019c4013144eafe3102e713eadde0bd61b2688ca0d1946a8601a6276fc43beccdf798225b67d65329bcaf3ceb12bc5e17ed542c6f131d8006
00
7865287ae2880e4a
*/
echo php_c_get_account_from_block($block, 0);
echo "\n";
echo php_c_get_account_from_block($block, 1);
echo "\n";
echo php_c_get_account_from_block($block, 0, NANO_PREFIX);
echo "\n";
echo php_c_get_account_from_block($block, 0, XRB_PREFIX);
?>Return value
# RETURN VALUE
nano_36e31pd5ssgp5dexgmbba7khoiuc1xxowctmtaeye8goxrz8brfi48iexshm
918105963CE5D61AD9D74D294164FAC36A077B5E2B53D219E619D5EE3E64E1B0
nano_36e31pd5ssgp5dexgmbba7khoiuc1xxowctmtaeye8goxrz8brfi48iexshm
xrb_36e31pd5ssgp5dexgmbba7khoiuc1xxowctmtaeye8goxrz8brfi48iexshmOn error
Throws MyNanoCEmbeddedException
Function [ <internal:mynanoembedded> function php_c_get_balance_from_block ] {
- Parameters [2] {
Parameter #0 [ <required> $block ]
Parameter #1 [ <optional> $balance_type ]
}
}Extracts balances from binary nano block
$res = php_c_get_balance_from_block($block, $balance_type);| params | type | description |
|---|---|---|
| $block | binary | Binary Nano block |
| $balance_type | integer | (Optional) Balance type. (See table below). If ommited balance type will be parsed to real value |
| $balance_type type | description |
|---|---|
| BALANCE_REAL_STRING | Real string value |
| BALANCE_RAW_STRING | Raw string value |
| BALANCE_RAW_128 | Hex string value |
Extracted Nano balance value
<?php
/*
Assuming Nano block below is in $block variable
0000000000000000000000000000000000000000000000000000000000000006
918105963ce5d61ad9d74d294164fac36a077b5e2b53d219e619d5ee3e64e1b0
f9252d13ec4103ccc6b1f1712c617413adc741d16a465452ca90c504d9f2c278
22f2c23d07f7eb43ebdb470e35493ebbadfdc447bd4b983623703767728974b6
00001b9dd181a316c69b1feb73b30000
f9640ff8804a3720efc9d2a190cdcac87011b6eb2bff9bcda6e15400ec76d8b08
4daaa49ccf95d10353b93711c24e605aa2219dac2e5020996619f7184bb8733ee733d2a2e033481aa5bf82652aa201b63a58f6ef4cd43a8468f6112d4ad8d07
00
7865287ae2880e4a
*/
echo php_c_get_balance_from_block($block);
echo "\n";
echo php_c_get_balance_from_block($block, BALANCE_RAW_128);
echo "\n";
echo php_c_get_balance_from_block($block, BALANCE_RAW_STRING);
echo "\n";
echo php_c_get_balance_from_block($block, BALANCE_REAL_STRING);
echo "\n";
echo "Finally Hello World\n";
?>Return value
# RETURN VALUE
560.12871990198387 # Real value
00001b9dd181a316c69b1feb73b30000 # Hex string value
560128719901983870000000000000000 # Raw balance string
560.12871990198387 # Real value
Finally Hello WorldOn error
Throws MyNanoCEmbeddedException
Function [ <internal:mynanoembedded> function php_c_get_block_hash ] {
- Parameters [1] {
Parameter #0 [ <required> $block ]
}
}Calculates block hash in Nano Block
$res = php_c_get_block_hash($block);| params | type | description |
|---|---|---|
| $block | binary | Binary Nano block |
Nano block hash
<?php
/*
Assuming Nano block below is in $block variable
0000000000000000000000000000000000000000000000000000000000000006
918105963ce5d61ad9d74d294164fac36a077b5e2b53d219e619d5ee3e64e1b0
f9252d13ec4103ccc6b1f1712c617413adc741d16a465452ca90c504d9f2c278
22f2c23d07f7eb43ebdb470e35493ebbadfdc447bd4b983623703767728974b6
00001b9dd181a316c69b1feb73b30000
f9640ff8804a3720efc9d2a190cdcac87011b6eb2bff9bcda6e15400ec76d8b08
4daaa49ccf95d10353b93711c24e605aa2219dac2e5020996619f7184bb8733ee733d2a2e033481aa5bf82652aa201b63a58f6ef4cd43a8468f6112d4ad8d07
00
7865287ae2880e4a
*/
echo php_c_get_block_hash($block);
echo "\nFinally Hello World\n";
?>Return value
# RETURN VALUE
200D55EB5D65BD5CBB095E20873D7E7900D58496CAEB3CA263C778BA9D932C95
Finally Hello WorldOn error
Throws MyNanoCEmbeddedException
Function [ <internal:mynanoembedded> function php_c_get_difficulty ] {
- Parameters [3] {
Parameter #0 [ <required> $hash ]
Parameter #1 [ <required> $work ]
Parameter #2 [ <optional> $threshold ]
}
}Calculates a relative difficulty given a work, hash and threshold
$res = php_c_get_difficulty($hash, $work, $threshold);| params | type | description |
|---|---|---|
| $block | string | Hash of the block |
| $work | string | Calculated work |
| $threshold | string | (Optional) Threshold. If threshold is ommited then DEFAULT_NANO_POW_THRESHOLD = 0xffffffc000000000 is assumed |
JSON string value
php -r "echo php_c_get_difficulty('F9252D13EC4103CCC6B1F1712C617413ADC741D16A465452CA90C504D9F2C278', '0x4a0e88e27a286578');"Return value
# RETURN VALUE
{
"hash": "F9252D13EC4103CCC6B1F1712C617413ADC741D16A465452CA90C504D9F2C278",
"work": "0x4a0e88e27a286578",
"difficulty": "0xffffffef5e1596a0",
"base_difficulty": "0xffffffc000000000",
"multiplier": "3.84789208342411",
"valid": "1"
}php -r "echo php_c_get_difficulty('97754bc2448355786175c4f8f46ee281336fda0ef83c06a3524b1664c9c9bb6a', '0x300607865057a2fb');"Return value
# RETURN VALUE
{
"hash": "97754bc2448355786175c4f8f46ee281336fda0ef83c06a3524b1664c9c9bb6a",
"work": "0x300607865057a2fb",
"difficulty": "0xfffffff81bffd01f",
"base_difficulty": "0xffffffc000000000",
"multiplier": "8.11088815564106",
"valid": "1"
}php -r "echo php_c_get_difficulty('97754bc2448355786175c4f8f46ee281336fda0ef83c06a3524b1664c9c9bb6a', '18446743901642424320');"
# 18446743901642424320(decimal) = 0xffffffd7f0000000(hex)
# Use 0x prefix for hexadecimal Ex.: 0xffffffd7f0000000
# Use 0 prefic for octal. Ex.: 01777777775376000000000
# No prefix for decimal. Ex.: 18446743901642424320Return value
# RETURN VALUE
{
"hash": "b0cbcbe1b522fbac1ba1b1880dcea19afdae31008a242b7d9c6165982559fe53",
"work": "0xa5422ca8ae8ca022",
"difficulty": "0xfffffff23e8131c1",
"base_difficulty": "0xffffffd7f0000000",
"multiplier": "2.91239914457107",
"valid": "1"
}On error
Throws MyNanoCEmbeddedException
See also
- php_c_nano_proof_of_work()
Function [ <internal:mynanoembedded> function php_c_get_entropy_name ] {
- Parameters [1] {
Parameter #0 [ <required> $entropy ]
}
}Get a entropy name string given a index or entropy value
$res = php_c_get_entropy_name($entropy);| params | type | description |
|---|---|---|
| $entropy | integer | Entropy value, index or char index value |
String value of the entropy
php -r "echo php_c_get_entropy_name(1);"Return value
F_ENTROPY_TYPE_PARANOICphp -r "echo php_c_get_entropy_name('1');"Return value
F_ENTROPY_TYPE_PARANOICphp -r "echo php_c_get_entropy_name('2');"Return value
F_ENTROPY_TYPE_EXCELENTphp -r "echo php_c_get_entropy_name(ENTROPY_TYPE_GOOD);"Return value
F_ENTROPY_TYPE_GOOD Function [ <internal:mynanoembedded> function php_c_get_link_from_block ] {
- Parameters [3] {
Parameter #0 [ <required> $block ]
Parameter #1 [ <optional> $type ]
Parameter #2 [ <optional> $prefix ]
}
}
```sh
### Description
Extracts link with encoded Nano Base32 string or link hex string
```php
$res = php_c_get_link_from_block($block, $type, $prefix);| params | type | description |
|---|---|---|
| $block | binary | Binary Nano block |
| $type | integer | Type 0 for wallet address (with nano_ or xrb_ prefixes) or 1 for hex string (link) |
| $prefix | string | (Optional) If ommited, then prefix will be NANO_PREFIX prefix when type is 0. Choose NANO_PREFIX or XRB_PREFIX prefixes |
Extracted Nano link as account with encoded Base32 or hex string public key
<?php
/*
Assuming Nano block below is in $block variable
0000000000000000000000000000000000000000000000000000000000000006
918105963ce5d61ad9d74d294164fac36a077b5e2b53d219e619d5ee3e64e1b0
f9252d13ec4103ccc6b1f1712c617413adc741d16a465452ca90c504d9f2c278
22f2c23d07f7eb43ebdb470e35493ebbadfdc447bd4b983623703767728974b6
000000000052b7d2dcc80cd2e4000000
f9640ff8804a3720efc9d2a190cdcac87011b6eb2bff9bcda6e15400ec76d8b0
d6a78e49f87bb5e019c4013144eafe3102e713eadde0bd61b2688ca0d1946a8601a6276fc43beccdf798225b67d65329bcaf3ceb12bc5e17ed542c6f131d8006
00
7865287ae2880e4a
*/
echo php_c_get_link_from_block($block, 0);
echo "\n";
echo php_c_get_link_from_block($block, 1);
echo "\n";
echo php_c_get_link_from_block($block, 0, NANO_PREFIX);
echo "\n";
echo php_c_get_link_from_block($block, 0, XRB_PREFIX);
?>Return value
# RETURN VALUE
nano_3yd63zwa1kjq65qwmno3k58wok5i48ugpczzmh8tfrcn15p9fp7it3ptoj8w
F9640FF8804A3720EFC9D2A190CDCAC87011B6EB2BFF9BCDA6E15400EC76D8B0
nano_3yd63zwa1kjq65qwmno3k58wok5i48ugpczzmh8tfrcn15p9fp7it3ptoj8w
xrb_3yd63zwa1kjq65qwmno3k58wok5i48ugpczzmh8tfrcn15p9fp7it3ptoj8wOn error
Throws MyNanoCEmbeddedException
Function [ <internal:mynanoembedded> function php_c_get_prefixes_from_block ] {
- Parameters [1] {
Parameter #0 [ <required> $block ]
}
}Extracts prefixes from Nano block
$res = php_c_get_prefixes_from_block($block);| params | type | description |
|---|---|---|
| $block | binary | Binary Nano block |
Prefixes information of the Nano block as integer
<?php
/*
Assuming Nano block below is in $block variable
0000000000000000000000000000000000000000000000000000000000000006
918105963ce5d61ad9d74d294164fac36a077b5e2b53d219e619d5ee3e64e1b0
f9252d13ec4103ccc6b1f1712c617413adc741d16a465452ca90c504d9f2c278
22f2c23d07f7eb43ebdb470e35493ebbadfdc447bd4b983623703767728974b6
000000000052b7d2dcc80cd2e4000000
f9640ff8804a3720efc9d2a190cdcac87011b6eb2bff9bcda6e15400ec76d8b0
d6a78e49f87bb5e019c4013144eafe3102e713eadde0bd61b2688ca0d1946a8601a6276fc43beccdf798225b67d65329bcaf3ceb12bc5e17ed542c6f131d8006
00
7865287ae2880e4a
*/
echo php_c_get_prefixes_from_block($block);
echo "\n";
?>Return value
0 #Returns 0 (Account, Destination or Link, Representative) are in nano_ prefixOn error
Throws MyNanoCEmbeddedException
Function [ <internal:mynanoembedded> function php_c_get_previous_from_block ] {
- Parameters [1] {
Parameter #0 [ <required> $block ]
}
}Extracts previous hash from Nano Block
$res = php_c_get_previous_from_block($block);| params | type | description |
|---|---|---|
| $block | binary | Binary Nano block |
Previous block Nano hash
<?php
/*
Assuming Nano block below is in $block variable
0000000000000000000000000000000000000000000000000000000000000006
918105963ce5d61ad9d74d294164fac36a077b5e2b53d219e619d5ee3e64e1b0
f9252d13ec4103ccc6b1f1712c617413adc741d16a465452ca90c504d9f2c278
22f2c23d07f7eb43ebdb470e35493ebbadfdc447bd4b983623703767728974b6
000000000052b7d2dcc80cd2e4000000
f9640ff8804a3720efc9d2a190cdcac87011b6eb2bff9bcda6e15400ec76d8b0
d6a78e49f87bb5e019c4013144eafe3102e713eadde0bd61b2688ca0d1946a8601a6276fc43beccdf798225b67d65329bcaf3ceb12bc5e17ed542c6f131d8006
00
7865287ae2880e4a
*/
echo php_c_get_previous_from_block($block);
echo "\n";
?>Return value
F9252D13EC4103CCC6B1F1712C617413ADC741D16A465452CA90C504D9F2C278On error
Throws MyNanoCEmbeddedException
Extracts representative with encoded Nano Base32 string or link hex string
$res = php_c_get_representative_from_block($block, $type, $prefix);| params | type | description |
|---|---|---|
| $block | binary | Binary Nano block |
| $type | integer | Type 0 for wallet address (with nano_ or xrb_ prefixes) or 1 for hex string (link) |
| $prefix | string | (Optional) If ommited, then prefix will be NANO_PREFIX prefix when type is 0. Choose NANO_PREFIX or XRB_PREFIX prefixes |
Extracted Nano representative with encoded Base32 or hex string public key
<?php
/*
Assuming Nano block below is in $block variable
0000000000000000000000000000000000000000000000000000000000000006
918105963ce5d61ad9d74d294164fac36a077b5e2b53d219e619d5ee3e64e1b0
f9252d13ec4103ccc6b1f1712c617413adc741d16a465452ca90c504d9f2c278
22f2c23d07f7eb43ebdb470e35493ebbadfdc447bd4b983623703767728974b6
000000000052b7d2dcc80cd2e4000000
f9640ff8804a3720efc9d2a190cdcac87011b6eb2bff9bcda6e15400ec76d8b0
d6a78e49f87bb5e019c4013144eafe3102e713eadde0bd61b2688ca0d1946a8601a6276fc43beccdf798225b67d65329bcaf3ceb12bc5e17ed542c6f131d8006
00
7865287ae2880e4a
*/
echo php_c_get_representative_from_block($block, 0);
echo "\n";
echo php_c_get_representative_from_block($block, 1);
echo "\n";
echo php_c_get_representative_from_block($block, 0, NANO_PREFIX);
echo "\n";
echo php_c_get_representative_from_block($block, 0, XRB_PREFIX);
?>Return value
# RETURN VALUE
nano_1aqkrayihxzdahoxpjrg8o6mxgxfzq46hhcdm1u48w3qexsakx7pzzhjn3fc
22F2C23D07F7EB43EBDB470E35493EBBADFDC447BD4B983623703767728974B6
nano_1aqkrayihxzdahoxpjrg8o6mxgxfzq46hhcdm1u48w3qexsakx7pzzhjn3fc
xrb_1aqkrayihxzdahoxpjrg8o6mxgxfzq46hhcdm1u48w3qexsakx7pzzhjn3fcOn error
Throws MyNanoCEmbeddedException
Extracts previous hash from Nano Block
$res = php_c_get_signature_from_block($block);| params | type | description |
|---|---|---|
| $block | binary | Binary Nano block |
Signature of the Nano Block
<?php
/*
Assuming Nano block below is in $block variable
0000000000000000000000000000000000000000000000000000000000000006
918105963ce5d61ad9d74d294164fac36a077b5e2b53d219e619d5ee3e64e1b0
f9252d13ec4103ccc6b1f1712c617413adc741d16a465452ca90c504d9f2c278
22f2c23d07f7eb43ebdb470e35493ebbadfdc447bd4b983623703767728974b6
000000000052b7d2dcc80cd2e4000000
f9640ff8804a3720efc9d2a190cdcac87011b6eb2bff9bcda6e15400ec76d8b0
d6a78e49f87bb5e019c4013144eafe3102e713eadde0bd61b2688ca0d1946a8601a6276fc43beccdf798225b67d65329bcaf3ceb12bc5e17ed542c6f131d8006
00
7865287ae2880e4a
*/
echo php_c_get_signature_from_block($block);
echo "\n";
?>Return value
D6A78E49F87BB5E019C4013144EAFE3102E713EADDE0BD61B2688CA0D1946A8601A6276FC43BECCDF798225B67D65329BCAF3CEB12BC5E17ED542C6F131D8006On error
Throws MyNanoCEmbeddedException
Extract calculated work from Nano Block
$res = php_c_get_work_from_block($block);| params | type | description |
|---|---|---|
| $block | binary | Binary Nano block |
Calculated work from Nano Block
<?php
/*
Assuming Nano block below is in $block variable
0000000000000000000000000000000000000000000000000000000000000006
918105963ce5d61ad9d74d294164fac36a077b5e2b53d219e619d5ee3e64e1b0
f9252d13ec4103ccc6b1f1712c617413adc741d16a465452ca90c504d9f2c278
22f2c23d07f7eb43ebdb470e35493ebbadfdc447bd4b983623703767728974b6
000000000052b7d2dcc80cd2e4000000
f9640ff8804a3720efc9d2a190cdcac87011b6eb2bff9bcda6e15400ec76d8b0
d6a78e49f87bb5e019c4013144eafe3102e713eadde0bd61b2688ca0d1946a8601a6276fc43beccdf798225b67d65329bcaf3ceb12bc5e17ed542c6f131d8006
00
7865287ae2880e4a
*/
echo php_c_get_work_from_block($block);
echo "\n";
?>Return value
0x4a0e88e27a286578On error
Throws MyNanoCEmbeddedException
Information about myNanoPHP C library in JSON string format
$res = php_c_library_info();Info about myNanoPHP C Library in JSON string format
Prints MIT license clausule
$res = php_c_license();MIT license text string
Verifies if a signature of a hash is valid using Nano wallet (xrb_ or nano_) or public key
$res = php_c_nano_check_sig($singature, $message, $nano_pk);| params | type | description |
|---|---|---|
| $signature | string | Signature of the message |
| $message | string | Hash of the message in Blake2b |
| $nano_pk | string | Base32 encoded Nano wallet or Nano public key |
True if signature is valid or False if signature is invalid
php -r "echo (php_c_nano_check_sig('3FFD1927EFB8747174A4124057AEE94A58C9304F123C0C7921A8F102F1B5C53C2B1A30E078C9533A01B95D7E9B78F4063E7D4F9B696828FE673B4422AA62E604', 'D572DC8E6F179AF1BB223D8946AFC6411EC35D7CD3176A8E2DA3CC2FC41DA30B', 'nano_3xemzomy4atzmq5u55mzzixqw9zxykyeyeiqia7rb1xy1saufpr8wzder1xh'))?'TRUE':'FALSE';"Return value
TRUEphp -r "echo (php_c_nano_check_sig('8235D51B5E80B695A93E11985E69279A0ED0024941469D8F447E701D97A8F612320A0D784A4ACBC162DAEDD682797F23A4FADAD78093356F89A2FF57C7B9A400', 'CAC6B8707B3978771C9044E91C430172400852374D2A3EE65FE08CB259F69233', 'xrb_1qpmofer8nymj1mwmegxfjhqqpcwwm78uiqtshrrpkoij47b8apdc4y5apor'))?'TRUE':'FALSE';"Return value
TRUEphp -r "echo (php_c_nano_check_sig('784AD4EF466745ACE911F0A5103DB030B6A505912284C2BC03E852A68BE16E16DBEAD6CCE2D1EB4169D0DB188430424870A2AFD0098014F3E282172B4AB7E808', 'AAAE2E008893C35CC1C53FD7643AA4E851F6BA332A314FE31D1B345066F7E384', '511AC43730543F18C07836BB2F61032B16EDA46F10779CA0F330C9B663881060'))?'TRUE':'FALSE';"Return value
TRUEOn error
Throws MyNanoCEmbeddedException
Calculates a Proof of Work of a given hash with multithread support
$res = php_c_nano_proof_of_work($hash, $n_thr, $threshold);| params | type | description |
|---|---|---|
| $hash | string | Hash to be computed |
| $n_thr | string | Number of CPU threads |
| $threshold | string | (Optional) Threshold. If ommitted then DEFAULT_NANO_POW_THRESHOLD = 0xffffffc000000000 is used |
Calculated Proof of Work of the hash in JSON string format
php -r "echo php_c_nano_proof_of_work('4e5e494fa316ffc82b8252b23524f1433639858267d641c1217059dc4403e045', 4);"Return value
{
"pow":"0xfdbf88e2507dc654",
"threshold":"0xffffffc000000000",
"multiplier":"1.000000000000000"
}php -r "echo php_c_nano_proof_of_work('4e5e494fa316ffc82b8252b23524f1433639858267d641c1217059dc4403e045', 4, '0xfffffff000000000');"Return value
{
"pow":"0xa03503b1bebcc2fb",
"threshold":"0xfffffff000000000",
"multiplier":"4.000000000000000"
}On error
Throws MyNanoCEmbeddedException
Parses a Nano SEED to Bip39 mnemonic
$res = php_c_nano_seed_to_bip39($seed, $dictionary_path);| params | type | description |
|---|---|---|
| $seed | string | Nano SEED to be parsed |
| $dictionary_path | string | Path and name of the dictionary *.dic |
Bip39 encoded string
php -r "echo php_c_nano_seed_to_bip39('27e990765dfa506201a0ba85288efd33502864d18e42cb0873fe3a3dc21a7132', '/var/www/html/dictionary.dic');"Return value
child erode budget room pink country alley blanket lunch dutch satisfy grit action crash economy sign slam drum zebra inner switch artwork shadow extraOn error
Throws MyNanoCEmbeddedException
Parses a Nano SEED to Bip39 mnemonic
$res = php_c_nano_verify_work($hash, $work, $threshold);| params | type | description |
|---|---|---|
| $hash | string | Nano SEED to be parsed |
| $work | string | Work |
| $threshold | string | (Optional) Threshold. If ommitted then DEFAULT_NANO_POW_THRESHOLD = 0xffffffc000000000 is used |
TRUE is work is valid or FALSE is is invalid
php -r "echo (php_c_nano_verify_work('4e5e494fa316ffc82b8252b23524f1433639858267d641c1217059dc4403e045', '0xfdbf88e2507dc654', '0xfffffffc00000000'))?'TRUE':'FALSE';"Return value
FALSEphp -r "echo (php_c_nano_verify_work('4e5e494fa316ffc82b8252b23524f1433639858267d641c1217059dc4403e045', '0xfdbf88e2507dc654'))?'TRUE':'FALSE';"Return value
TRUEphp -r "echo (php_c_nano_verify_work('4e5e494fa316ffc82b8252b23524f1433639858267d641c1217059dc4403e045', '0xfdbf88e2507dc654', '0xfffffffc00000000'))?'TRUE':'FALSE';"Return value
TRUEphp -r "echo (php_c_nano_verify_work('4e5e494fa316ffc82b8252b23524f1433639858267d641c1217059dc4403e045', '0x54bc660196cd155a', '0xfffffffc00000000'))?'TRUE':'FALSE';"Return value
TRUEOn error
Throws MyNanoCEmbeddedException
Parses a Nano SEED to Bip39 mnemonic
$res = php_c_nano_wallet_to_public_key($Nano);| params | type | description |
|---|---|---|
| $Nano | string | Nano wallet Base32 encoded to be parsed |
Hex string value of the extracted public key
php -r "echo php_c_nano_wallet_to_public_key('nano_1ru5kyg89aerkby6fbwndxchk7ksr3de1bafkz1r4k1796pbubjujrypwsdu');"Return value
6363979C63A198927C46A7945F54F91659C056C0250D97C1814805392C9DA63Bphp -r "echo php_c_nano_wallet_to_public_key('xrb_3oj16m1u5h3m9buboxynbwndxyksiy4rjet5cy5nj8fhgjw5h7msrhxud3sz');"Return value
D62024C1B1BC333A769AF7D44F28BEFA59878588B34357874899AF7478379679On error
Throws MyNanoCEmbeddedException
Parses a P2PoW Nano block to JSON
$res = php_c_p2pow_to_json($block);| params | type | description |
|---|---|---|
| $block | string | P2PoW Nano block to be parsed to JSON |
Formated JSON string
Create a file p2pow2json.php and type:
<?php
//mon jun 01 2020 15:24:27 -03
/*
* EXAMPLE: Parse P2PoW to JSON example
*/
echo "STEP1: Create Nano Block to receive 2.281 Nanos (open block) from link 79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1\n";
//account_private_key => SECURITY WARNING !!! Private key must be in a safe place. NEVER tell your Private KEY, SEED, Bip39 or Brainwallet to ANYBODY
$account_private_key = '19B8423A2D010067C03F88A35836967894009D439FDAE79B29CDEA8B06C0062F97A886ECB1EE8BA6B0E455D1419FBEBA367986810CB3220AE0B9F9A585C86779';
/////////////////////////////////////////////////////////// $account_private_key (KEEP IT SAFE) /////////////////////////////////////////////////////////
$account = 'nano_37xaiupd5undntrgaogja8huxgjph85a457m6a7g3ghsnp4wisusx1mqkigg';
$previous = 'F9252D12EC2103CAD6B2E7212C617413ADC741D16A465452CA90C504D9F2C278';
$representative = 'nano_1aqkrayihxzdahoxpjrg8o6mxgxfzq46hhcdm1u48w3qexsakx7pzzhjn3fc';
$balance = '16.2300118101';
$balance_type = BALANCE_REAL_STRING;
$value_to_send = '2.281';
$value_to_send_type = VALUE_SEND_RECEIVE_REAL_STRING;
$destination = '79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1';
$direction = VALUE_TO_RECEIVE;
try {
$nano_block = php_c_generate_block(
$account,
$previous,
$representative,
$balance,
$balance_type,
$value_to_send,
$value_to_send_type,
$destination,
$direction
);
} catch (Exception $e) {
echo 'Error code: '.$e->getCode()."\nError message: ".$e->getMessage();
exit(1);
}
echo "SUCCESS: Nano block created. Now adding fee to Nano block ...\nSTEP 2:\n";
$worker_wallet = 'nano_3oj16m1u5h3m9buboxynbwndxyksiy4rjet5cy5nj8fhgjw5h7msrhxud3sz';
$worker_representative = ''; /* if '' then $worker_representative = $representative */
$worker_fee = '0.0001';
$worker_fee_type = WORKER_FEE_REAL; /* worker fee is represented in real value. It could be ommited in this case (real value)*/
try {
$worker_fee_block = php_c_block_to_p2pow(
$nano_block,
$worker_wallet,
$worker_representative,
$worker_fee,
$worker_fee_type
);
} catch (Exception $e) {
echo "Error code in 'php_c_block_to_p2pow' ".$e->getCode()."Error message: ".$e->getMessage();
exit(1);
}
echo "\nSTEP3: Signing your P2PoW block with private keypair ...\n";
try {
php_c_sign_p2pow_block($worker_fee_block, $account_private_key);
} catch (Exception $e) {
echo "Error code in 'php_c_sign_p2pow_block' ".$e->getCode()."Error message: ".$e->getMessage();
exit(1);
}
echo "SUCCESS\nP2PoW Fee block signed block =>\n";
echo bin2hex($worker_fee_block);
echo "\nSTEP4: Parsing P2PoW to JSON ...\n";
try {
$p2pow_to_json = php_c_p2pow_to_json($worker_fee_block);
} catch (Exception $e) {
echo "Error code in 'php_c_p2pow_to_json' ".$e->getCode()."Error message: ".$e->getMessage();
exit(1);
}
echo "\nSUCCESS: P2PoW JSON signed block:\n\n";
echo $p2pow_to_json;
echo "\n\nFinally Hello World\n";
?>php p2pow2json.phpReturn value
STEP1: Create Nano Block to receive 2.281 Nanos (open block) from link 79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1
SUCCESS: Nano block created. Now adding fee to Nano block ...
STEP 2:
STEP3: Signing your P2PoW block with private keypair ...
SUCCESS
P2PoW Fee block signed block =>
0000000000000000000000000000000000000000000000000000000000000006
97a886ecb1ee8ba6b0e455d1419fbeba367986810cb3220ae0b9f9a585c86779
f9252d12ec2103cad6b2e7212c617413adc741d16a465452ca90c504d9f2c278
22f2c23d07f7eb43ebdb470e35493ebbadfdc447bd4b983623703767728974b6
000000e9a44e168ac332b4814c500000
79640f38102a3728efc9d2a190cdcac87011b6eb2bff9bcd10f12405ec76d8c1
5de3b33b503cc2eb206bcfd29add24d1e1b6548b5ceafe73f75f5b10948ceb887cfa6779f86f6690b84dfaf4dc8e7fdd3b0639f560cc9b78d01262cd99ee390a
00
0000000000000000
0000000000000000000000000000000000000000000000000000000000000006
97a886ecb1ee8ba6b0e455d1419fbeba367986810cb3220ae0b9f9a585c86779
2fc9637c3b2681d03f9167173641869a54f2b2a326cd41f05c82b68f05e69f7f
22f2c23d07f7eb43ebdb470e35493ebbadfdc447bd4b983623703767728974b6
000000e9a3fb5eb7e66aa7ae68500000
d62024c1b1bc333a769af7d44f28befa59878588b34357874899af7478379679
bf6837f2a826731e544f5cc4993fceaca652f47c696069cb95e83e5f2a3660d04eeccc2f659c5b510031204ae9f3607b0188ec60d77ae0c2126f2808c81cf605
00
0000000000000000
STEP4: Parsing P2PoW to JSON ...
SUCCESS: P2PoW JSON signed block:
{
"user_transaction": {
"block_type": "state",
"account": "nano_37xaiupd5undntrgaogja8huxgjph85a457m6a7g3ghsnp4wisusx1mqkigg",
"previous": "F9252D12EC2103CAD6B2E7212C617413ADC741D16A465452CA90C504D9F2C278",
"representative": "nano_1aqkrayihxzdahoxpjrg8o6mxgxfzq46hhcdm1u48w3qexsakx7pzzhjn3fc",
"balance": "18511011810100000000000000000000",
"link": "79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1",
"link_as_account": "nano_1yd63ww31cjq75qwmno3k58wok5i48ugpczzmh8j3wb61qp9fp835zfzanwe",
"signature": "5DE3B33B503CC2EB206BCFD29ADD24D1E1B6548B5CEAFE73F75F5B10948CEB887CFA6779F86F6690B84DFAF4DC8E7FDD3B0639F560CC9B78D01262CD99EE390A"
},
"worker_transaction": {
"block_type": "state",
"account": "nano_37xaiupd5undntrgaogja8huxgjph85a457m6a7g3ghsnp4wisusx1mqkigg",
"previous": "2FC9637C3B2681D03F9167173641869A54F2B2A326CD41F05C82B68F05E69F7F",
"representative": "nano_1aqkrayihxzdahoxpjrg8o6mxgxfzq46hhcdm1u48w3qexsakx7pzzhjn3fc",
"balance": "18510911810100000000000000000000",
"link": "D62024C1B1BC333A769AF7D44F28BEFA59878588B34357874899AF7478379679",
"link_as_account": "nano_3oj16m1u5h3m9buboxynbwndxyksiy4rjet5cy5nj8fhgjw5h7msrhxud3sz",
"signature": "BF6837F2A826731E544F5CC4993FCEACA652F47C696069CB95E83E5F2A3660D04EECCC2F659C5B510031204AE9F3607B0188EC60D77AE0C2126F2808C81CF605"
}
}
Finally Hello World
On error
Throws MyNanoCEmbeddedException
Parses a Nano block to JSON
$res = php_c_parse_block_to_json($block);| params | type | description |
|---|---|---|
| $block | string | Nano block to be parsed to JSON |
Formated JSON string
Create a file block2json.php and type:
<?php
//tue jun 02 2020 01:58 -03
/*
* EXAMPLE: Parse Nano block to JSON example
*/
echo "STEP1: Create Nano Block to receive 2.281 Nanos (open block) from link 79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1\n";
//account_private_key => SECURITY WARNING !!! Private key must be in a safe place. NEVER tell your Private KEY, SEED, Bip39 or Brainwallet to ANYBODY
$account_private_key = '19B8423A2D010067C03F88A35836967894009D439FDAE79B29CDEA8B06C0062F97A886ECB1EE8BA6B0E455D1419FBEBA367986810CB3220AE0B9F9A585C86779';
/////////////////////////////////////////////////////////// $account_private_key (KEEP IT SAFE) /////////////////////////////////////////////////////////
$account = 'nano_37xaiupd5undntrgaogja8huxgjph85a457m6a7g3ghsnp4wisusx1mqkigg';
$previous = 'F9252D12EC2103CAD6B2E7212C617413ADC741D16A465452CA90C504D9F2C278';
$representative = 'nano_1aqkrayihxzdahoxpjrg8o6mxgxfzq46hhcdm1u48w3qexsakx7pzzhjn3fc';
$balance = '16.2300118101';
$balance_type = BALANCE_REAL_STRING;
$value_to_send = '2.281';
$value_to_send_type = VALUE_SEND_RECEIVE_REAL_STRING;
$destination = '79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1';
$direction = VALUE_TO_RECEIVE;
try {
$nano_block = php_c_generate_block(
$account,
$previous,
$representative,
$balance,
$balance_type,
$value_to_send,
$value_to_send_type,
$destination,
$direction
);
} catch (Exception $e) {
echo 'Error code: '.$e->getCode()."\nError message: ".$e->getMessage();
exit(1);
}
echo "SUCCESS: Nano block created. Signing the block ...\nSTEP 2:\n";
try {
$nano_block_signed = php_c_sign_block($nano_block, null, $account_private_key);
} catch (Exception $e) {
echo "Error code in 'php_c_sign_block' ".$e->getCode()."Error message: ".$e->getMessage();
exit(1);
}
echo "SUCCESS\nNano block signed block =>\n";
echo bin2hex($nano_block_signed);
echo "\nSTEP3: Calculating work ...\nIt can take a little longer... Wait ...\n";
try {
php_c_calculate_work_from_block($nano_block_signed, 4); // 4 threads
} catch (Exception $e) {
echo "Error code in 'php_c_calculate_work_from_block' ".$e->getCode()."Error message: ".$e->getMessage();
exit(1);
}
echo "SUCCESS\nNano block signed block and with work =>\n";
echo bin2hex($nano_block_signed);
echo "\nSUCCESS: Work done:\n\nNow parsing to JSON ...\nSTEP 4:\n";
echo php_c_parse_block_to_json($nano_block_signed);
echo "\n\nFinally Hello World\n";
?>php block2json.phpReturn value
STEP1: Create Nano Block to receive 2.281 Nanos (open block) from link 79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1
SUCCESS: Nano block created. Signing the block ...
STEP 2:
SUCCESS
Nano block signed block =>
0000000000000000000000000000000000000000000000000000000000000006
97a886ecb1ee8ba6b0e455d1419fbeba367986810cb3220ae0b9f9a585c86779
f9252d12ec2103cad6b2e7212c617413adc741d16a465452ca90c504d9f2c278
22f2c23d07f7eb43ebdb470e35493ebbadfdc447bd4b983623703767728974b6
000000e9a44e168ac332b4814c500000
79640f38102a3728efc9d2a190cdcac87011b6eb2bff9bcd10f12405ec76d8c1
5de3b33b503cc2eb206bcfd29add24d1e1b6548b5ceafe73f75f5b10948ceb887cfa6779f86f6690b84dfaf4dc8e7fdd3b0639f560cc9b78d01262cd99ee390a
00
0000000000000000
STEP3: Calculating work ...
It can take a little longer... Wait ...
SUCCESS
Nano block signed block and with work =>
0000000000000000000000000000000000000000000000000000000000000006
97a886ecb1ee8ba6b0e455d1419fbeba367986810cb3220ae0b9f9a585c86779
f9252d12ec2103cad6b2e7212c617413adc741d16a465452ca90c504d9f2c278
22f2c23d07f7eb43ebdb470e35493ebbadfdc447bd4b983623703767728974b6
000000e9a44e168ac332b4814c500000
79640f38102a3728efc9d2a190cdcac87011b6eb2bff9bcd10f12405ec76d8c1
5de3b33b503cc2eb206bcfd29add24d1e1b6548b5ceafe73f75f5b10948ceb887cfa6779f86f6690b84dfaf4dc8e7fdd3b0639f560cc9b78d01262cd99ee390a
00
cae98de011f0df7b
SUCCESS: Work done:
Now parsing to JSON ...
STEP 4:
{
"action": "process",
"json_block": "true",
"block": {
"type": "state",
"account": "nano_37xaiupd5undntrgaogja8huxgjph85a457m6a7g3ghsnp4wisusx1mqkigg",
"previous": "F9252D12EC2103CAD6B2E7212C617413ADC741D16A465452CA90C504D9F2C278",
"representative": "nano_1aqkrayihxzdahoxpjrg8o6mxgxfzq46hhcdm1u48w3qexsakx7pzzhjn3fc",
"balance": "18511011810100000000000000000000",
"link": "79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1",
"link_as_account": "nano_1yd63ww31cjq75qwmno3k58wok5i48ugpczzmh8j3wb61qp9fp835zfzanwe",
"signature": "5DE3B33B503CC2EB206BCFD29ADD24D1E1B6548B5CEAFE73F75F5B10948CEB887CFA6779F86F6690B84DFAF4DC8E7FDD3B0639F560CC9B78D01262CD99EE390A",
"work": "7BDFF011E08DE9CA"
}
}
Finally Hello World
On error
Throws MyNanoCEmbeddedException
See also
- php_c_generate_block()
Parses a public key to Base32 encoded string (Nano Wallet) with prefix
$res = php_c_public_key_to_nano_wallet($public_key, $nano_prefix);| params | type | description |
|---|---|---|
| $public_key | string | Public key of the block |
| $nano_prefix | string | (Optional) Prefix. If ommited then Prefix will be nano_ |
Nano wallet (Base32 encoded string with selected prefix);
php -r "echo php_c_public_key_to_nano_wallet('79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1');"Return value
nano_1yd63ww31cjq75qwmno3k58wok5i48ugpczzmh8j3wb61qp9fp835zfzanwephp -r "echo php_c_public_key_to_nano_wallet('F9252D12EC2103CAD6B2E7212C617413ADC741D16A465452CA90C504D9F2C278', NANO_PREFIX);"Return value
nano_3yb77nbgraa5sddd7ss37jiqa6xfrx1x4tk8cjbeo6871mez7imr9fr9x4j6php -r "echo php_c_public_key_to_nano_wallet('98B5E79DBC175AEFB986036AB2E4ECF3E816B8854A2D53CE80A37A648F5AEC0D', XRB_PREFIX);"Return value
xrb_387owygur7ttxywre1ucpdkgswza4twackjfch9a3autek9oou1fdwtu9kndOn error
Throws MyNanoCEmbeddedException
Returns a Nano keypair given a Nano SEED
$res = php_c_seed_to_nano_key_pair($seed, $wallet_number, $prefix);| params | type | description |
|---|---|---|
| $Nano | string | Nano SEED |
| $wallet_number | string | Wallet number |
| $prefix | string | (Optional) Nano prefix. If ommited then nano_ prefix is used |
JSON string format with wallet and keypair
php -r "echo php_c_seed_to_nano_key_pair('00d75b5176b48ccc71d91bcc1d7b90fc2820429b1629b77fd1d5f4c5dcee4f6d', '0');"Return value
{
"private_key":"289067B1E7E53A18520632B5CEB874D71B02C281B838185ADE4CD729E0E6E5C7",
"public_key":"0EE36F17F489284FB4C298A8B56B2A6734A0A2D75C1520EEA78D9B0650C7A7A3",
"wallet_number":"0",
"wallet":"nano_15q5fwdzb4babyte787apooknssnn4jfgq1o65qch5eu1saehbx5tzb5fmm7"
}php -r "echo php_c_seed_to_nano_key_pair('00d75b5176b48ccc71d91bcc1d7b90fc2820429b1629b77fd1d5f4c5dcee4f6d', '0x20', NANO_PREFIX);"Return value
{
"private_key":"11B43CD23FFC787A6ED6993A3CE96E55CE91626D765CB930487129497483825B",
"public_key":"6B69991A3A40393EDDEC60E41BE9B36B3FB64F300046090B1852DBDD379B2F4C",
"wallet_number":"32",
"wallet":"nano_1tubm6f5ni3s9ugyrr965hnu8tszps9m1148367jinpuunuspdte9wjaowp6"
}php -r "echo php_c_seed_to_nano_key_pair('00d75b5176b48ccc71d91bcc1d7b90fc2820429b1629b77fd1d5f4c5dcee4f6d', '027', XRB_PREFIX);"Return value
{
"private_key":"8F8C322EEE9A4513C486B16DEC1F3531896684EE3DAEC5AF480D43447A9918F2",
"public_key":"40404148158A9095BC947207D200D1CB555993F9C85823830FEA3A624F49F41C",
"wallet_number":"23",
"wallet":"xrb_1i41a763d4nikpybawi9ta1f5ktod8bzmk4r6g3iztjteb9nmx1wfwysurwf"
}On error
Throws MyNanoCEmbeddedException
Function [ <internal:mynanoembedded> function php_c_set_account_to_block ] {
- Parameters [2] {
Parameter #0 [ <required> &$block ]
Parameter #1 [ <required> $wallet ]
}
}
Set/modify an account in a Nano block
php_c_set_account_to_block(&$block, $wallet);| params | type | description |
|---|---|---|
| &$block | binary | Nano block |
| $wallet | string | Wallet (Nano base32 encoded string) or public key |
Modified Nano block
<?php
//tue jun 02 2020 21:07
/*
* EXAMPLE1
*/
echo "STEP1: Create Nano Block to receive 2.281 Nanos (open block) from link 79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1\n";
$account = 'nano_37xaiupd5undntrgaogja8huxgjph85a457m6a7g3ghsnp4wisusx1mqkigg';
$previous = 'F9252D12EC2103CAD6B2E7212C617413ADC741D16A465452CA90C504D9F2C278';
$representative = 'nano_1aqkrayihxzdahoxpjrg8o6mxgxfzq46hhcdm1u48w3qexsakx7pzzhjn3fc';
$balance = '16.2300118101';
$balance_type = BALANCE_REAL_STRING;
$value_to_send = '2.281';
$value_to_send_type = VALUE_SEND_RECEIVE_REAL_STRING;
$link = '79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1';
$direction = VALUE_TO_RECEIVE;
try {
$nano_block = php_c_generate_block(
$account,
$previous,
$representative,
$balance,
$balance_type,
$value_to_send,
$value_to_send_type,
$link,
$direction
);
} catch (Exception $e) {
echo 'Error code: '.$e->getCode()."\nError message: ".$e->getMessage();
exit(1);
}
$new_account = 'xrb_1i41a763d4nikpybawi9ta1f5ktod8bzmk4r6g3iztjteb9nmx1wfwysurwf';
echo "\nChanging account ".$account." to ".$new_account."\n\n";
try {
php_c_set_account_to_block($nano_block, $new_account);
} catch (Exception $e) {
echo 'Error code: '.$e->getCode()."\nError message: ".$e->getMessage();
exit(1);
}
echo "Success\nAccount ".$account." changed to ".$new_account."\n\nFinally Hello World !";
?>Return value
STEP1: Create Nano Block to receive 2.281 Nanos (open block) from link 79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1
Changing account nano_37xaiupd5undntrgaogja8huxgjph85a457m6a7g3ghsnp4wisusx1mqkigg to xrb_1i41a763d4nikpybawi9ta1f5ktod8bzmk4r6g3iztjteb9nmx1wfwysurwf
Success
Account nano_37xaiupd5undntrgaogja8huxgjph85a457m6a7g3ghsnp4wisusx1mqkigg changed to xrb_1i41a763d4nikpybawi9ta1f5ktod8bzmk4r6g3iztjteb9nmx1wfwysurwf
Finally Hello World !
# Binary block before
# 0000000000000000000000000000000000000000000000000000000000000006
# 97a886ecb1ee8ba6b0e455d1419fbeba367986810cb3220ae0b9f9a585c86779
# f9252d12ec2103cad6b2e7212c617413adc741d16a465452ca90c504d9f2c278
# 22f2c23d07f7eb43ebdb470e35493ebbadfdc447bd4b983623703767728974b6
# 000000e9a44e168ac332b4814c500000
# 79640f38102a3728efc9d2a190cdcac87011b6eb2bff9bcd10f12405ec76d8c1
# 00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
# 00
# 0000000000000000
# Human readable block before (JSON equivalent)
# {
# "action": "process",
# "json_block": "true",
# "block": {
# "type": "state",
# "account": "nano_37xaiupd5undntrgaogja8huxgjph85a457m6a7g3ghsnp4wisusx1mqkigg",
# "previous": "F9252D12EC2103CAD6B2E7212C617413ADC741D16A465452CA90C504D9F2C278",
# "representative": "nano_1aqkrayihxzdahoxpjrg8o6mxgxfzq46hhcdm1u48w3qexsakx7pzzhjn3fc",
# "balance": "18511011810100000000000000000000",
# "link": "79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1",
# "link_as_account": "nano_1yd63ww31cjq75qwmno3k58wok5i48ugpczzmh8j3wb61qp9fp835zfzanwe",
# "signature": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
# "work": "0000000000000000"
# }
# }
# Binary block after
# 0000000000000000000000000000000000000000000000000000000000000006
# 40404148158a9095bc947207d200d1cb555993f9c85823830fea3a624f49f41c
# f9252d12ec2103cad6b2e7212c617413adc741d16a465452ca90c504d9f2c278
# 22f2c23d07f7eb43ebdb470e35493ebbadfdc447bd4b983623703767728974b6
# 000000e9a44e168ac332b4814c500000
# 79640f38102a3728efc9d2a190cdcac87011b6eb2bff9bcd10f12405ec76d8c1
# 00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
# 02
# 0000000000000000
# Human readable block after (JSON equivalent)
# {
# "action": "process",
# "json_block": "true",
# "block": {
# "type": "state",
# "account": "xrb_1i41a763d4nikpybawi9ta1f5ktod8bzmk4r6g3iztjteb9nmx1wfwysurwf",
# "previous": "F9252D12EC2103CAD6B2E7212C617413ADC741D16A465452CA90C504D9F2C278",
# "representative": "nano_1aqkrayihxzdahoxpjrg8o6mxgxfzq46hhcdm1u48w3qexsakx7pzzhjn3fc",
# "balance": "18511011810100000000000000000000",
# "link": "79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1",
# "link_as_account": "nano_1yd63ww31cjq75qwmno3k58wok5i48ugpczzmh8j3wb61qp9fp835zfzanwe",
# "signature": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
# "work": "0000000000000000"
# }
# }
<?php
//tue jun 02 2020 21:07
/*
* EXAMPLE2
*/
echo "STEP1: Create Nano Block to receive 2.281 Nanos (open block) from link 79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1\n";
$account = 'nano_37xaiupd5undntrgaogja8huxgjph85a457m6a7g3ghsnp4wisusx1mqkigg';
$previous = 'F9252D12EC2103CAD6B2E7212C617413ADC741D16A465452CA90C504D9F2C278';
$representative = 'nano_1aqkrayihxzdahoxpjrg8o6mxgxfzq46hhcdm1u48w3qexsakx7pzzhjn3fc';
$balance = '16.2300118101';
$balance_type = BALANCE_REAL_STRING;
$value_to_send = '2.281';
$value_to_send_type = VALUE_SEND_RECEIVE_REAL_STRING;
$link = '79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1';
$direction = VALUE_TO_RECEIVE;
try {
$nano_block = php_c_generate_block(
$account,
$previous,
$representative,
$balance,
$balance_type,
$value_to_send,
$value_to_send_type,
$link,
$direction
);
} catch (Exception $e) {
echo 'Error code: '.$e->getCode()."\nError message: ".$e->getMessage();
exit(1);
}
$new_account = 'nano_1nxx3pham5o6ufatmrzzp47raozthsdb3n9xwtfaeic8bgfaw9bhth31qmru';
echo "\nChanging account ".$account." to ".$new_account."\n\n";
try {
php_c_set_account_to_block($nano_block, $new_account);
} catch (Exception $e) {
echo 'Error code: '.$e->getCode()."\nError message: ".$e->getMessage();
exit(1);
}
echo "Success\nAccount ".$account." changed to ".$new_account."\n\nFinally Hello World !";
?>Return value
STEP1: Create Nano Block to receive 2.281 Nanos (open block) from link 79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1
Changing account nano_37xaiupd5undntrgaogja8huxgjph85a457m6a7g3ghsnp4wisusx1mqkigg to nano_1nxx3pham5o6ufatmrzzp47raozthsdb3n9xwtfaeic8bgfaw9bhth31qmru
Success
Account nano_37xaiupd5undntrgaogja8huxgjph85a457m6a7g3ghsnp4wisusx1mqkigg changed to nano_1nxx3pham5o6ufatmrzzp47raozthsdb3n9xwtfaeic8bgfaw9bhth31qmru
Finally Hello World !
# Binary block before
# 0000000000000000000000000000000000000000000000000000000000000006
# 97a886ecb1ee8ba6b0e455d1419fbeba367986810cb3220ae0b9f9a585c86779
# f9252d12ec2103cad6b2e7212c617413adc741d16a465452ca90c504d9f2c278
# 22f2c23d07f7eb43ebdb470e35493ebbadfdc447bd4b983623703767728974b6
# 000000e9a44e168ac332b4814c500000
# 79640f38102a3728efc9d2a190cdcac87011b6eb2bff9bcd10f12405ec76d8c1
# 00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
# 00
# 0000000000000000
# Human readable block before (JSON equivalent)
# {
# "action": "process",
# "json_block": "true",
# "block": {
# "type": "state",
# "account": "nano_37xaiupd5undntrgaogja8huxgjph85a457m6a7g3ghsnp4wisusx1mqkigg",
# "previous": "F9252D12EC2103CAD6B2E7212C617413ADC741D16A465452CA90C504D9F2C278",
# "representative": "nano_1aqkrayihxzdahoxpjrg8o6mxgxfzq46hhcdm1u48w3qexsakx7pzzhjn3fc",
# "balance": "18511011810100000000000000000000",
# "link": "79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1",
# "link_as_account": "nano_1yd63ww31cjq75qwmno3k58wok5i48ugpczzmh8j3wb61qp9fp835zfzanwe",
# "signature": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
# "work": "0000000000000000"
# }
# }
# Binary block after
# 0000000000000000000000000000000000000000000000000000000000000006
# 53bd0d9e898ea4db51a9e3ffb08b8457fa7e5690d0fde69a8641464b9a8e1d2f
# f9252d12ec2103cad6b2e7212c617413adc741d16a465452ca90c504d9f2c278
# 22f2c23d07f7eb43ebdb470e35493ebbadfdc447bd4b983623703767728974b6
# 000000e9a44e168ac332b4814c500000
# 79640f38102a3728efc9d2a190cdcac87011b6eb2bff9bcd10f12405ec76d8c1
# 00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
# 00
# 0000000000000000
# Human readable block after (JSON equivalent)
# {
# {
# "action": "process",
# "json_block": "true",
# "block": {
# "type": "state",
# "account": "nano_1nxx3pham5o6ufatmrzzp47raozthsdb3n9xwtfaeic8bgfaw9bhth31qmru",
# "previous": "F9252D12EC2103CAD6B2E7212C617413ADC741D16A465452CA90C504D9F2C278",
# "representative": "nano_1aqkrayihxzdahoxpjrg8o6mxgxfzq46hhcdm1u48w3qexsakx7pzzhjn3fc",
# "balance": "18511011810100000000000000000000",
# "link": "79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1",
# "link_as_account": "nano_1yd63ww31cjq75qwmno3k58wok5i48ugpczzmh8j3wb61qp9fp835zfzanwe",
# "signature": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
# "work": "0000000000000000"
# }
# }<?php
//tue jun 02 2020 21:07
/*
* EXAMPLE3
*/
echo "STEP1: Create Nano Block to receive 2.281 Nanos (open block) from link 79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1\n";
$account = 'nano_37xaiupd5undntrgaogja8huxgjph85a457m6a7g3ghsnp4wisusx1mqkigg';
$previous = 'F9252D12EC2103CAD6B2E7212C617413ADC741D16A465452CA90C504D9F2C278';
$representative = 'nano_1aqkrayihxzdahoxpjrg8o6mxgxfzq46hhcdm1u48w3qexsakx7pzzhjn3fc';
$balance = '16.2300118101';
$balance_type = BALANCE_REAL_STRING;
$value_to_send = '2.281';
$value_to_send_type = VALUE_SEND_RECEIVE_REAL_STRING;
$link = '79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1';
$direction = VALUE_TO_RECEIVE;
try {
$nano_block = php_c_generate_block(
$account,
$previous,
$representative,
$balance,
$balance_type,
$value_to_send,
$value_to_send_type,
$link,
$direction
);
} catch (Exception $e) {
echo 'Error code: '.$e->getCode()."\nError message: ".$e->getMessage();
exit(1);
}
$new_account = '51BD5E2C122A7D505838A2165338BDCE48940B1E66AE0682799EFD39BD7DD618';
echo "\nChanging account ".$account." to ".$new_account."\n\n";
try {
php_c_set_account_to_block($nano_block, $new_account);
} catch (Exception $e) {
echo 'Error code: '.$e->getCode()."\nError message: ".$e->getMessage();
exit(1);
}
echo "Success\nAccount ".$account." changed to ".$new_account."\n\nFinally Hello World !";
?>Return value
STEP1: Create Nano Block to receive 2.281 Nanos (open block) from link 79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1
Changing account nano_37xaiupd5undntrgaogja8huxgjph85a457m6a7g3ghsnp4wisusx1mqkigg to 51BD5E2C122A7D505838A2165338BDCE48940B1E66AE0682799EFD39BD7DD618
Success
Account nano_37xaiupd5undntrgaogja8huxgjph85a457m6a7g3ghsnp4wisusx1mqkigg changed to 51BD5E2C122A7D505838A2165338BDCE48940B1E66AE0682799EFD39BD7DD618
Finally Hello World !
# Binary block before
# 0000000000000000000000000000000000000000000000000000000000000006
# 97a886ecb1ee8ba6b0e455d1419fbeba367986810cb3220ae0b9f9a585c86779
# f9252d12ec2103cad6b2e7212c617413adc741d16a465452ca90c504d9f2c278
# 22f2c23d07f7eb43ebdb470e35493ebbadfdc447bd4b983623703767728974b6
# 000000e9a44e168ac332b4814c500000
# 79640f38102a3728efc9d2a190cdcac87011b6eb2bff9bcd10f12405ec76d8c1
# 00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
# 00
# 0000000000000000
# Human readable block before (JSON equivalent)
# {
# "action": "process",
# "json_block": "true",
# "block": {
# "type": "state",
# "account": "nano_37xaiupd5undntrgaogja8huxgjph85a457m6a7g3ghsnp4wisusx1mqkigg",
# "previous": "F9252D12EC2103CAD6B2E7212C617413ADC741D16A465452CA90C504D9F2C278",
# "representative": "nano_1aqkrayihxzdahoxpjrg8o6mxgxfzq46hhcdm1u48w3qexsakx7pzzhjn3fc",
# "balance": "18511011810100000000000000000000",
# "link": "79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1",
# "link_as_account": "nano_1yd63ww31cjq75qwmno3k58wok5i48ugpczzmh8j3wb61qp9fp835zfzanwe",
# "signature": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
# "work": "0000000000000000"
# }
# }
# Binary block after
# 0000000000000000000000000000000000000000000000000000000000000006
# 51bd5e2c122a7d505838a2165338bdce48940b1e66ae0682799efd39bd7dd618
# f9252d12ec2103cad6b2e7212c617413adc741d16a465452ca90c504d9f2c278
# 22f2c23d07f7eb43ebdb470e35493ebbadfdc447bd4b983623703767728974b6
# 000000e9a44e168ac332b4814c500000
# 79640f38102a3728efc9d2a190cdcac87011b6eb2bff9bcd10f12405ec76d8c1
# 00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
# 00
# 0000000000000000
# Human readable block after (JSON equivalent)
# {
# "action": "process",
# "json_block": "true",
# "block": {
# "type": "state",
# "account": "nano_1nfxdrp36cmxc3e5jaipcewdumkaki7jwsog1t39m9qx98yquoirow9mb1ad",
# "previous": "F9252D12EC2103CAD6B2E7212C617413ADC741D16A465452CA90C504D9F2C278",
# "representative": "nano_1aqkrayihxzdahoxpjrg8o6mxgxfzq46hhcdm1u48w3qexsakx7pzzhjn3fc",
# "balance": "18511011810100000000000000000000",
# "link": "79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1",
# "link_as_account": "nano_1yd63ww31cjq75qwmno3k58wok5i48ugpczzmh8j3wb61qp9fp835zfzanwe",
# "signature": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
# "work": "0000000000000000"
# }
# }On error
Throws MyNanoCEmbeddedException
Set/modify an account balance
php_c_set_balance(&$block, $balance, $balance_type);| params | type | description |
|---|---|---|
| &$block | binary | Nano block |
| $balance | string | Nano big number balance |
| $balance_type | integer | Balance type (See below) |
| $balance_type type | description |
|---|---|
| BALANCE_REAL_STRING | Real string value |
| BALANCE_RAW_STRING | Raw string value |
| BALANCE_RAW_128 | Hex string value |
Nano block reference &$block with modified balance
// Assuming $block1, $block2 and $block3 variables are already created
php_c_set_balance($block1, '12702.18726458194', BALANCE_REAL_STRING); // Assigns real value 12702.18726458194 to $block1
php_c_set_balance($block2, '254000000000000000000000000000000', BALANCE_RAW_STRING); // Assigns raw value (254) to $block2
php_c_set_balance($block3, '000011d126edc439aee12bdec7800000', BALANCE_RAW_128); // Assigns hex value (361.3716971) to $block3On error
Throws MyNanoCEmbeddedException
See also
- php_c_get_balance_from_block()
Set/modify a link or Nano account
php_c_set_link_to_block(&$block, $link);| params | type | description |
|---|---|---|
| &$block | binary | Nano block |
| $link | string | Nano link or Nano account (Base32 encoded string) |
Nano block reference &$block with modified link or Nano account
// Assuming $block1, $block2 and $block3 variables are already created
php_c_set_link_to_block($block1, 'E0AF835D2257133F507DE787728ABB48C644E950BB7894CB822A5768E01F91D2'); // Assigns link to $block1
php_c_set_link_to_block($block2, 'nano_3bgfqdzh6kcpysiqczsiox6zufnj7bdtqndt9e4wgbjo4pdwp7irdrnz5inm'); // Assigns Nano account to $block2
php_c_set_link_to_block($block3, 'xrb_3p4cc397w9zqz8otcft181wm9utrz94kc9xku5fu1wh7p43h1cpk7pju3ebs'); // Assigns Nano account to $block3On error
Throws MyNanoCEmbeddedException
See also
- php_c_get_link_from_block()
Set/modifies Block wallets prefixes
php_c_set_prefixes(&$block, $prefixes);| params | type | description |
|---|---|---|
| &$block | binary | Nano block |
| $prefixes | integer | Prefixes |
Nano block reference &$block with modified prefix(es)
// Assuming $block1, $block2, $block3 and $block4 variables are already created
php_c_set_prefixes($block1, REP_XRB); // Changes representative prefix _nano__ to _xrb__ in $block1
php_c_set_prefixes($block2, SENDER_XRB); // Changes sender (account) prefix _nano__ to _xrb__ in $block2
php_c_set_prefixes($block3, DEST_XRB|REP_XRB); // Changes destination and representative prefixes _nano__ to _xrb__ in $block3
php_c_set_prefixes($block1, 0); // Changes all wallets (account, representative and destination) to _nano__ prefixes in $block1On error
Throws MyNanoCEmbeddedException
See also
- php_c_get_prefixes_from_block()
Set/modify a previous hash in Nano Block
php_c_set_previous(&$block, $previous);| params | type | description |
|---|---|---|
| &$block | binary | Nano block |
| $previous | string | Previous block |
Nano block reference &$block with modified previous hash
// Assuming $block1 is already created
php_c_set_previous($block1, 'E2455BE7630528084F3B43AFE7F65335D6FEEF88798BE717523979DE4B93C28F'); // Assigns previous hash to $block1On error
Throws MyNanoCEmbeddedException
See also
- php_c_get_previous_from_block()
Function [ <internal:mynanoembedded> function php_c_set_representative_to_block ] {
- Parameters [2] {
Parameter #0 [ <required> &$block ]
Parameter #1 [ <required> $representative ]
}
}Set/modify a representative Nano account or public key in Nano block
php_c_set_representative_to_block(&$block, $representative);| params | type | description |
|---|---|---|
| &$block | binary | Nano block |
| $representative | string | Nano representative coded in Base32 or representative public key |
Nano block reference &$block with modified representative account
// Assuming $block1, $block2 and $block3 variables are already created
php_c_set_representative_to_block($block1, '3AFA0DF128384B227CBD319C1D2F794A2B5097306B1CCB9412E113317D2C512A'); // Assigns representative to $block1
php_c_set_representative_to_block($block2, 'nano_396sch48s3jmzq1bk31pxxpz64rn7joj38emj4ueypkb9p9mzrym34obze6c'); // Assigns Nano account representative to $block2
php_c_set_representative_to_block($block3, 'xrb_3rw4un6ys57hrb39sy1qx8qy5wukst1iiponztrz9qiz6qqa55kxzx4491or'); // Assigns Nano account representative to $block3On error
Throws MyNanoCEmbeddedException
See also
- php_c_get_representative_from_block()
Function [ <internal:mynanoembedded> function php_c_set_signature ] {
- Parameters [2] {
Parameter #0 [ <required> &$block ]
Parameter #1 [ <required> $signature ]
}
}Set/modify a signature to a Nano block
php_c_set_signature(&$block, $signature);| params | type | description |
|---|---|---|
| &$block | binary | Nano block |
| $signature | string | Signature to be assigned in Nano block |
Nano block reference &$block with modified signature
// Assuming $block1 is already created
php_c_set_signature($block1, '2C67CCE89396C62A1D8ACCDD27478DF27FC2180A10CFB8866B5B4EB14BEE5FD9D431FCD13B59DF28674571FF128080C770890B3E26CC2943308A9E4C87F9B004'); // Assigns signature to $block1On error
Throws MyNanoCEmbeddedException
See also
- php_c_get_signature_from_block()
Function [ <internal:mynanoembedded> function php_c_set_work ] {
- Parameters [2] {
Parameter #0 [ <required> &$block ]
Parameter #1 [ <required> $work ]
}
}Set/modify work in Nano Block
php_c_set_work(&$block, $work);| params | type | description |
|---|---|---|
| &$block | binary | Nano block |
| $work | string | String long value |
Nano block reference &$block with modified work
// Assuming $block1, $block2 and $block3 variables are already created
php_c_set_work($block1, '0xf91404332afb3c7e'); // Assigns work value 0xf91404332afb3c7e to $block1On error
Throws MyNanoCEmbeddedException
See also
- php_c_get_work_from_block()
Function [ <internal:mynanoembedded> function php_c_sign_block ] {
- Parameters [3] {
Parameter #0 [ <required> $user_block ]
Parameter #1 [ <required> $fee_block ]
Parameter #2 [ <required> $private_key ]
}
}- Function 1: Takes a Nano Block and signs with the private_key and returns a new variable with signed Nano Block
- Function 2: Takes a Nano Block and a second fee Block and signs with the private key and returns a P2POW signed block variable
php_c_sign_block($user_block, $fee_block, $private_key);| params | type | description |
|---|---|---|
| $user_block | binary | Input user Nano block |
| $fee_block | binary | Input fee Nano block. If null then function returns only signed Nano block, else returns P2PoW block |
| $private_key | string | Private key |
Signed Nano block or signed P2PoW block
<?php
//mon jun 08 2020 21:17:14 -03
/*
* EXAMPLE 1: Prepares a block to send (receive 117.2718 Nanos) to xrb_3dq4ar8q8miufrfc3h5omtssfe7setpd6uzafp39d5jiqdd7zghktgqjhqde
*/
echo "Create Nano Block to send 117.2718 Nanos to wallet xrb_3dq4ar8q8miufrfc3h5omtssfe7setpd6uzafp39d5jiqdd7zghktgqjhqde\n";
// Private Key. Keep it in a safe place
$private_key = 'EBC79E9DA540D6F4D43C94C2353A83907715BC02A333C986B47863D165D1D861737D687273EDBD69A79240A595D93A3A703FB7C25CA8AFBA6891BB5E946A2BAF';
$account = 'nano_1wuxf3s99ufxf8ms6i77kqemngmi9yuw6q7aoyx8j6fudtc8ncxhkb9ty31t';
$previous = '7D77FABE00D9B6737D82D50A14D8F304CFF88E92C93FB4EF87A63EF6B8BFA0B6';
$representative = 'nano_3ph9in8bb9k4byej3pqkgkinwewnrwdoj6cksikxeappqwhugwc8ebrf7y8p';
$balance = '2200.10019711029838738198836102';
$balance_type = BALANCE_REAL_STRING;
$value_to_send = '117.2718';
$value_to_send_type = VALUE_SEND_RECEIVE_REAL_STRING;
$destination = 'xrb_3dq4ar8q8miufrfc3h5omtssfe7setpd6uzafp39d5jiqdd7zghktgqjhqde';
$direction = VALUE_TO_SEND;
try {
$nano_block = php_c_generate_block(
$account,
$previous,
$representative,
$balance,
$balance_type,
$value_to_send,
$value_to_send_type,
$destination,
$direction
);
} catch (Exception $e) {
echo 'Error code: '.$e->getCode()."\nError message: ".$e->getMessage();
exit(1);
}
echo "Successfully block stored in memory in \$nano_block variable\n";
echo "Signing block ...\n";
try {
$signed_nano_block = php_c_sign_block(
$nano_block,
null,
$private_key
);
} catch (Exception $e) {
echo 'Error code: '.$e->getCode()."\nError message: ".$e->getMessage();
exit(1);
}
echo "Signed block successfully\n\n";
?>Return value
Create Nano Block to send 117.2718 Nanos to wallet xrb_3dq4ar8q8miufrfc3h5omtssfe7setpd6uzafp39d5jiqdd7zghktgqjhqde
Successfully block stored in memory in $nano_block variable
Signing block ...
Signed block successfully
# Binary signed Nano Block block result representation in Memory (249 Bytes long)
# 0000000000000000000000000000000000000000000000000000000000000006
# 737d687273edbd69a79240a595d93a3a703fb7c25ca8afba6891bb5e946a2baf
# 7d77fabe00d9b6737d82d50a14d8f304cff88e92c93fb4ef87a63ef6b8bfa0b6
# d9e7850c949e424f9910daf274a14e3394c717589152cc25d622d6bf1fb77146
# 000066b0fd855d5252a716a1c0cca260
# aee2460d734e1b6e1aa0bc759eb396b0b966acb26fe86d82758e30bad65fb9f2
# bde3c973b540cc6575ef99a967184bd6285b6c532d4a8e6fd0259661d8e0d21b0ed0f237f6a9e38f312415a8e7b7e26a0280cb2deefb93b904f6105f99968209
# 01
# 0000000000000000
#Human readable result (JSON Equivalent)
# {
# "action": "process",
# "json_block": "true",
# "block": {
# "type": "state",
# "account": "nano_1wuxf3s99ufxf8ms6i77kqemngmi9yuw6q7aoyx8j6fudtc8ncxhkb9ty31t",
# "previous": "7D77FABE00D9B6737D82D50A14D8F304CFF88E92C93FB4EF87A63EF6B8BFA0B6",
# "representative": "nano_3ph9in8bb9k4byej3pqkgkinwewnrwdoj6cksikxeappqwhugwc8ebrf7y8p",
# "balance": "2082828397110298387381988361020000",
# "link": "AEE2460D734E1B6E1AA0BC759EB396B0B966ACB26FE86D82758E30BAD65FB9F2",
# "link_as_account": "xrb_3dq4ar8q8miufrfc3h5omtssfe7setpd6uzafp39d5jiqdd7zghktgqjhqde",
# "signature": "BDE3C973B540CC6575EF99A967184BD6285B6C532D4A8E6FD0259661D8E0D21B0ED0F237F6A9E38F312415A8E7B7E26A0280CB2DEEFB93B904F6105F99968209",
# "work": "0000000000000000"
# }
# }
<?php
//mon jun 08 2020 21:41 -03
/*
* EXAMPLE 2: Prepares a block to send 117.2718 Nanos to xrb_3dq4ar8q8miufrfc3h5omtssfe7setpd6uzafp39d5jiqdd7zghktgqjhqd
* with fee 0.0025 to worker wallet nano_3gqw3xj3k3pdcbt7agkawxjhjwxcjku68dcearr8hf9e779c4fkncabcxbdd
* Using php_c_generate_block() to create signed p2pow block is not recommended due to code efficiency.
*
* Please, use php_c_block_to_p2pow() and php_c_sign_p2pow_block() instead
*/
echo "Create Nano Block to send 117.2718 Nanos to wallet nano_3ext7q1a41teoezpewstucbts611a6gk7q5g69xgxn753kdcudurr91y999w\n";
echo "with fee 0.00025 to worker wallet nano_3gqw3xj3k3pdcbt7agkawxjhjwxcjku68dcearr8hf9e779c4fkncabcxbdd\n\n";
// Private Key. Keep it in a safe place
$private_key = '943CE14F9735244385B34ACFE82F9868E0F46B21C4B35D4D7D142CC784D3810877871ED613AE5E89CAB6534BBC60BC50BCB61302E29AADF4BF0F48684BA8F5DB';
$account = 'xrb_1xw95ud39dkyj97dentdqjidrn7wprbi7rntoqtdy5taf37tjxgu3ds1reop';
$previous = '7D77FABE00D9B6737D82D50A14D8F304CFF88E92C93FB4EF87A63EF6B8BFA0B6';
$representative = 'nano_3ph9in8bb9k4byej3pqkgkinwewnrwdoj6cksikxeappqwhugwc8ebrf7y8p';
$balance = '2200.10019711029838738198836102';
$balance_type = BALANCE_REAL_STRING;
$value_to_send = '117.2718';
$value_to_send_type = VALUE_SEND_RECEIVE_REAL_STRING;
$destination = 'xrb_3dq4ar8q8miufrfc3h5omtssfe7setpd6uzafp39d5jiqdd7zghktgqjhqde';
$direction = VALUE_TO_SEND;
// Creating user block
echo "Creating user block ...\n";
try {
$user_block = php_c_generate_block(
$account,
$previous,
$representative,
$balance,
$balance_type,
$value_to_send,
$value_to_send_type,
$destination,
$direction
);
} catch (Exception $e) {
echo 'Error code: '.$e->getCode()."\nError message: ".$e->getMessage();
exit(1);
}
echo "Successfully block stored in memory in \$user_block variable\n";
echo "Subtracting \$balance and \$value_to_send in previous block\n";
try {
// $new_balance = $balance - $value_to_send
$new_balance = php_c_add_sub_balance($balance, $value_to_send, NANO_SUB_A_B|NANO_RES_RAW_128|NANO_A_REAL_STRING|NANO_B_REAL_STRING);
} catch (Exception $e) {
echo 'Error code: '.$e->getCode()."\nError message: ".$e->getMessage();
exit(1);
}
echo "Creating worker fee block ...\n";
$worker_fee = '0.0025';
$worker_fee_type = VALUE_SEND_RECEIVE_REAL_STRING;
$worker_destination = 'nano_3gqw3xj3k3pdcbt7agkawxjhjwxcjku68dcearr8hf9e779c4fkncabcxbdd';
try {
$worker_block = php_c_generate_block(
$account,
$previous,
$representative,
$new_balance,
BALANCE_RAW_128,
$worker_fee,
$worker_fee_type,
$worker_destination,
$direction
);
} catch (Exception $e) {
echo 'Error code: '.$e->getCode()."\nError message: ".$e->getMessage();
exit(1);
}
echo "Signing P2PoW block...\n";
try {
$signed_p2pow_block = php_c_sign_block(
$user_block,
$worker_block,
$private_key
);
} catch (Exception $e) {
echo 'Error code: '.$e->getCode()."\nError message: ".$e->getMessage();
exit(1);
}
echo "P2PoW block signed successfully\n\n";
?>Return value
Create Nano Block to send 117.2718 Nanos to wallet nano_3ext7q1a41teoezpewstucbts611a6gk7q5g69xgxn753kdcudurr91y999w
with fee 0.00025 to worker wallet nano_3gqw3xj3k3pdcbt7agkawxjhjwxcjku68dcearr8hf9e779c4fkncabcxbdd
Creating user block ...
Successfully block stored in memory in $user_block variable
Subtracting $balance and $value_to_send in previous block
Creating worker fee block ...
Signing P2PoW block...
P2PoW block signed successfully
# Binary signed Nano Block block result representation in Memory (498 Bytes long)
# 0000000000000000000000000000000000000000000000000000000000000006
# 77871ed613ae5e89cab6534bbc60bc50bcb61302e29aadf4bf0f48684ba8f5db
# 7d77fabe00d9b6737d82d50a14d8f304cff88e92c93fb4ef87a63ef6b8bfa0b6
# d9e7850c949e424f9910daf274a14e3394c717589152cc25d622d6bf1fb77146
# 000066b0fd855d5252a716a1c0cca260
# aee2460d734e1b6e1aa0bc759eb396b0b966acb26fe86d82758e30bad65fb9f2
# 21612873f05eed303d91926f861ee9cf4d87eec3c4864c4b6e39f87ca24833c534a4f3cb68d474725fdffc39352c49eaca58f7351892de4ad5e6fd03bbafdf03
# 03
# 0000000000000000
# 0000000000000000000000000000000000000000000000000000000000000006
# 77871ed613ae5e89cab6534bbc60bc50bcb61302e29aadf4bf0f48684ba8f5db
# 0c453e8dd551635d0b5d36a83e88eb5aec2c783e08224fac338ff2f057863450
# d9e7850c949e424f9910daf274a14e3394c717589152cc25d622d6bf1fb77146
# 000066b0f57169bac31dd6097ccca260
# bafc0f621906cb5274543a48e762f8f3aa8cb6432d4c463067b4ec294ea13654
# cd376ddbce5fcc2a9cf1978f720da004bd3ad06bbb9ff9097a048e1c801d099999ca034a717218c9750e3876fa0c5b791e8db0b88eb1a8f1854cea951a32bc09
# 02
# 0000000000000000
#Human readable result (JSON Equivalent)
# {
# "user_transaction": {
# "block_type": "state",
# "account": "xrb_1xw95ud39dkyj97dentdqjidrn7wprbi7rntoqtdy5taf37tjxgu3ds1reop",
# "previous": "7D77FABE00D9B6737D82D50A14D8F304CFF88E92C93FB4EF87A63EF6B8BFA0B6",
# "representative": "nano_3ph9in8bb9k4byej3pqkgkinwewnrwdoj6cksikxeappqwhugwc8ebrf7y8p",
# "balance": "2082828397110298387381988361020000",
# "link": "AEE2460D734E1B6E1AA0BC759EB396B0B966ACB26FE86D82758E30BAD65FB9F2",
# "link_as_account": "xrb_3dq4ar8q8miufrfc3h5omtssfe7setpd6uzafp39d5jiqdd7zghktgqjhqde",
# "signature": "21612873F05EED303D91926F861EE9CF4D87EEC3C4864C4B6E39F87CA24833C534A4F3CB68D474725FDFFC39352C49EACA58F7351892DE4AD5E6FD03BBAFDF03"
# },
# "worker_transaction": {
# "block_type": "state",
# "account": "xrb_1xw95ud39dkyj97dentdqjidrn7wprbi7rntoqtdy5taf37tjxgu3ds1reop",
# "previous": "0C453E8DD551635D0B5D36A83E88EB5AEC2C783E08224FAC338FF2F057863450",
# "representative": "nano_3ph9in8bb9k4byej3pqkgkinwewnrwdoj6cksikxeappqwhugwc8ebrf7y8p",
# "balance": "2082825897110298387381988361020000",
# "link": "BAFC0F621906CB5274543A48E762F8F3AA8CB6432D4C463067B4EC294EA13654",
# "link_as_account": "nano_3gqw3xj3k3pdcbt7agkawxjhjwxcjku68dcearr8hf9e779c4fkncabcxbdd",
# "signature": "CD376DDBCE5FCC2A9CF1978F720DA004BD3AD06BBB9FF9097A048E1C801D099999CA034A717218C9750E3876FA0C5B791E8DB0B88EB1A8F1854CEA951A32BC09"
# }
# }
On error
Throws MyNanoCEmbeddedException
See also
- php_c_block_to_p2pow()
- php_c_sign_p2pow_block()
Function [ <internal:mynanoembedded> function php_c_sign_p2pow_block ] {
- Parameters [2] {
Parameter #0 [ <required> &$p2pow_block ]
Parameter #1 [ <required> $private_key ]
}
}- Signs a P2PoW block with a given private key
php_c_sign_p2pow_block(&$p2pow_block, $private_key);| params | type | description |
|---|---|---|
| &$p2pow_block | binary | Input user P2PoW block |
| $private_key | string | Private key to sign P2PoW block |
Signs reference $p2pow_block with private key $private_key
Create a file p2pow2_sign.php and type:
<?php
//mon jun 01 2020 15:24:27 -03
/*
* EXAMPLE: Sign P2PoW example
*/
echo "STEP1: Create Nano Block to receive 2.281 Nanos (open block) from link 79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1\n";
//account_private_key => SECURITY WARNING !!! Private key must be in a safe place. NEVER tell your Private KEY, SEED, Bip39 or Brainwallet to ANYBODY
$account_private_key = '19B8423A2D010067C03F88A35836967894009D439FDAE79B29CDEA8B06C0062F97A886ECB1EE8BA6B0E455D1419FBEBA367986810CB3220AE0B9F9A585C86779';
/////////////////////////////////////////////////////////// $account_private_key (KEEP IT SAFE) /////////////////////////////////////////////////////////
$account = 'nano_37xaiupd5undntrgaogja8huxgjph85a457m6a7g3ghsnp4wisusx1mqkigg';
$previous = 'F9252D12EC2103CAD6B2E7212C617413ADC741D16A465452CA90C504D9F2C278';
$representative = 'nano_1aqkrayihxzdahoxpjrg8o6mxgxfzq46hhcdm1u48w3qexsakx7pzzhjn3fc';
$balance = '16.2300118101';
$balance_type = BALANCE_REAL_STRING;
$value_to_send = '2.281';
$value_to_send_type = VALUE_SEND_RECEIVE_REAL_STRING;
$destination = '79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1';
$direction = VALUE_TO_RECEIVE;
try {
$nano_block = php_c_generate_block(
$account,
$previous,
$representative,
$balance,
$balance_type,
$value_to_send,
$value_to_send_type,
$destination,
$direction
);
} catch (Exception $e) {
echo 'Error code: '.$e->getCode()."\nError message: ".$e->getMessage();
exit(1);
}
echo "SUCCESS: Nano block created. Now adding fee to Nano block ...\nSTEP 2:\n";
$worker_wallet = 'nano_3oj16m1u5h3m9buboxynbwndxyksiy4rjet5cy5nj8fhgjw5h7msrhxud3sz';
$worker_representative = ''; /* if '' then $worker_representative = $representative */
$worker_fee = '0.0001';
$worker_fee_type = WORKER_FEE_REAL; /* worker fee is represented in real value. It could be ommited in this case (real value)*/
try {
$worker_fee_block = php_c_block_to_p2pow(
$nano_block,
$worker_wallet,
$worker_representative,
$worker_fee,
$worker_fee_type
);
} catch (Exception $e) {
echo "Error code in 'php_c_block_to_p2pow' ".$e->getCode()."Error message: ".$e->getMessage();
exit(1);
}
echo "\nSTEP3: Signing your P2PoW block with private keypair ...\n";
try {
php_c_sign_p2pow_block($worker_fee_block, $account_private_key);
} catch (Exception $e) {
echo "Error code in 'php_c_sign_p2pow_block' ".$e->getCode()."Error message: ".$e->getMessage();
exit(1);
}
echo "SUCCESS\nP2PoW Fee block signed block =>\n";
echo bin2hex($worker_fee_block);
echo "\nSTEP4: Parsing P2PoW to JSON ...\n";
try {
$p2pow_to_json = php_c_p2pow_to_json($worker_fee_block);
} catch (Exception $e) {
echo "Error code in 'php_c_p2pow_to_json' ".$e->getCode()."Error message: ".$e->getMessage();
exit(1);
}
echo "\nSUCCESS: P2PoW JSON signed block:\n\n";
echo $p2pow_to_json;
echo "\n\nFinally Hello World\n";
?>php p2pow2_sign.phpReturn value
STEP1: Create Nano Block to receive 2.281 Nanos (open block) from link 79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1
SUCCESS: Nano block created. Now adding fee to Nano block ...
STEP 2:
STEP3: Signing your P2PoW block with private keypair ...
SUCCESS
P2PoW Fee block signed block =>
0000000000000000000000000000000000000000000000000000000000000006
97a886ecb1ee8ba6b0e455d1419fbeba367986810cb3220ae0b9f9a585c86779
f9252d12ec2103cad6b2e7212c617413adc741d16a465452ca90c504d9f2c278
22f2c23d07f7eb43ebdb470e35493ebbadfdc447bd4b983623703767728974b6
000000e9a44e168ac332b4814c500000
79640f38102a3728efc9d2a190cdcac87011b6eb2bff9bcd10f12405ec76d8c1
5de3b33b503cc2eb206bcfd29add24d1e1b6548b5ceafe73f75f5b10948ceb887cfa6779f86f6690b84dfaf4dc8e7fdd3b0639f560cc9b78d01262cd99ee390a
00
0000000000000000
0000000000000000000000000000000000000000000000000000000000000006
97a886ecb1ee8ba6b0e455d1419fbeba367986810cb3220ae0b9f9a585c86779
2fc9637c3b2681d03f9167173641869a54f2b2a326cd41f05c82b68f05e69f7f
22f2c23d07f7eb43ebdb470e35493ebbadfdc447bd4b983623703767728974b6
000000e9a3fb5eb7e66aa7ae68500000
d62024c1b1bc333a769af7d44f28befa59878588b34357874899af7478379679
bf6837f2a826731e544f5cc4993fceaca652f47c696069cb95e83e5f2a3660d04eeccc2f659c5b510031204ae9f3607b0188ec60d77ae0c2126f2808c81cf605
00
0000000000000000
STEP4: Parsing P2PoW to JSON ...
SUCCESS: P2PoW JSON signed block:
{
"user_transaction": {
"block_type": "state",
"account": "nano_37xaiupd5undntrgaogja8huxgjph85a457m6a7g3ghsnp4wisusx1mqkigg",
"previous": "F9252D12EC2103CAD6B2E7212C617413ADC741D16A465452CA90C504D9F2C278",
"representative": "nano_1aqkrayihxzdahoxpjrg8o6mxgxfzq46hhcdm1u48w3qexsakx7pzzhjn3fc",
"balance": "18511011810100000000000000000000",
"link": "79640F38102A3728EFC9D2A190CDCAC87011B6EB2BFF9BCD10F12405EC76D8C1",
"link_as_account": "nano_1yd63ww31cjq75qwmno3k58wok5i48ugpczzmh8j3wb61qp9fp835zfzanwe",
"signature": "5DE3B33B503CC2EB206BCFD29ADD24D1E1B6548B5CEAFE73F75F5B10948CEB887CFA6779F86F6690B84DFAF4DC8E7FDD3B0639F560CC9B78D01262CD99EE390A"
},
"worker_transaction": {
"block_type": "state",
"account": "nano_37xaiupd5undntrgaogja8huxgjph85a457m6a7g3ghsnp4wisusx1mqkigg",
"previous": "2FC9637C3B2681D03F9167173641869A54F2B2A326CD41F05C82B68F05E69F7F",
"representative": "nano_1aqkrayihxzdahoxpjrg8o6mxgxfzq46hhcdm1u48w3qexsakx7pzzhjn3fc",
"balance": "18510911810100000000000000000000",
"link": "D62024C1B1BC333A769AF7D44F28BEFA59878588B34357874899AF7478379679",
"link_as_account": "nano_3oj16m1u5h3m9buboxynbwndxyksiy4rjet5cy5nj8fhgjw5h7msrhxud3sz",
"signature": "BF6837F2A826731E544F5CC4993FCEACA652F47C696069CB95E83E5F2A3660D04EECCC2F659C5B510031204AE9F3607B0188EC60D77AE0C2126F2808C81CF605"
}
}
Finally Hello World
On error
Throws MyNanoCEmbeddedException
See also
- php_c_block_to_p2pow()
- php_c_p2pow_to_json()
Throws MyNanoCEmbeddedException
Function [ <internal:mynanoembedded> function php_c_to_multiplier ] {
- Parameters [2] {
Parameter #0 [ <required> $difficulty ]
Parameter #1 [ <required> $base_difficulty ]
}
}Takes a difficulty and converts to Nano Proof of Work multiplier
php_c_to_multiplier($difficulty, $base_difficulty);| params | type | description |
|---|---|---|
| $difficulty | string | String value in Hex or Octal or Decimal value |
| $base_difficulty | string | String value in Hex or Octal or Decimal value |
Rerurns a Real value of a multiplier difficulty of the Proof of Work
php -r "echo php_c_to_multiplier('0xfffffff000000000', DEFAULT_NANO_POW_THRESHOLD);"
# RETURNS 4php -r "echo php_c_to_multiplier('0xfffffd5adee9340d', '0xfffff10000000000');"
# RETURNS 5.6710000000011php -r "echo php_c_to_multiplier('0xb0be377ad92a0800', '0612791712736716625');"
# RETURNS 3.23php -r "echo php_c_to_multiplier('0xe2f648e16fa3c600', '8212791982736716625');"
# RETURNS 4.891On error
Throws MyNanoCEmbeddedException
See also
- php_c_from_multiplier()
Function [ <internal:mynanoembedded> function php_c_verify_token ] {
- Parameters [3] {
Parameter #0 [ <required> $token ]
Parameter #1 [ <required> $data ]
Parameter #2 [ <required> $password ]
}
}Checks if a non deterministic hash token is valid given a data and password
php_c_verify_token($token, $data, $password);| params | type | description |
|---|---|---|
| $token | string | Non deterministic hex string token |
| $data | binary | Raw data or string value |
| $password | string | Password |
Rerurns TRUE if token is valid otherwise returns FALSE
# Generating a non deterministic HASH with Albert Einstein quote:
# 'Try not to become a man of success, but rather try to become a man of value (Albert Einstein)' and sign with password 'MyPassword@1234'
php -r "echo php_c_generate_token('Try not to become a man of success, but rather try to become a man of value (Albert Einstein)', 'MyPassword@1234');"
#RETURNS 19a13667a8172c809831f2e9820a3c9d
# Verify a non deterministic HASH = 19a13667a8172c809831f2e9820a3c9d with Albert Einstein quote:
# 'Try not to become a man of success, but rather try to become a man of value (Albert Einstein)' and sign with password 'MyPassword@1234'
php -r "echo (php_c_verify_token('19a13667a8172c809831f2e9820a3c9d', 'Try not to become a man of success, but rather try to become a man of value (Albert Einstein)', 'MyPassword@1234'))?'TRUE':'FALSE';";Return value
TRUEOn error
Throws MyNanoCEmbeddedException
See also
- php_c_generate_token()
php --re mynanoembeddedExtension [ <persistent> extension #15 mynanoembedded version 1.0 ] {
- Constants [69] {
Constant [ string DEFAULT_NANO_POW_THRESHOLD ] { 0xffffffc000000000 }
Constant [ string NANO_PREFIX ] { nano_ }
Constant [ string XRB_PREFIX ] { xrb_ }
Constant [ integer REAL_TO_RAW ] { 256 }
Constant [ integer RAW_TO_REAL ] { 2 }
Constant [ integer REAL_TO_HEX ] { 512 }
Constant [ integer HEX_TO_REAL ] { 1024 }
Constant [ integer RAW_TO_HEX ] { 2048 }
Constant [ integer HEX_TO_RAW ] { 4096 }
Constant [ integer ENTROPY_TYPE_PARANOIC ] { 1477682819 }
Constant [ integer ENTROPY_TYPE_EXCELENT ] { 1476885281 }
Constant [ integer ENTROPY_TYPE_GOOD ] { 1472531015 }
Constant [ integer ENTROPY_TYPE_NOT_ENOUGH ] { 1471001808 }
Constant [ integer ENTROPY_TYPE_NOT_RECOMENDED ] { 1470003345 }
Constant [ integer NANO_ADD_A_B ] { 1 }
Constant [ integer NANO_SUB_A_B ] { 2 }
Constant [ integer NANO_RES_RAW_128 ] { 256 }
Constant [ integer NANO_RES_RAW_STRING ] { 512 }
Constant [ integer NANO_RES_REAL_STRING ] { 1024 }
Constant [ integer NANO_A_RAW_128 ] { 4 }
Constant [ integer NANO_A_RAW_STRING ] { 8 }
Constant [ integer NANO_A_REAL_STRING ] { 16 }
Constant [ integer NANO_B_RAW_128 ] { 32 }
Constant [ integer NANO_B_RAW_STRING ] { 64 }
Constant [ integer NANO_B_REAL_STRING ] { 128 }
Constant [ integer NANO_COMPARE_EQ ] { 65536 }
Constant [ integer NANO_COMPARE_LT ] { 131072 }
Constant [ integer NANO_COMPARE_LEQ ] { 196608 }
Constant [ integer NANO_COMPARE_GT ] { 262144 }
Constant [ integer NANO_COMPARE_GEQ ] { 327680 }
Constant [ integer BRAIN_WALLET_VERY_POOR ] { 0 }
Constant [ integer BRAIN_WALLET_POOR ] { 1 }
Constant [ integer BRAIN_WALLET_VERY_BAD ] { 2 }
Constant [ integer BRAIN_WALLET_BAD ] { 3 }
Constant [ integer BRAIN_WALLET_VERY_WEAK ] { 4 }
Constant [ integer BRAIN_WALLET_WEAK ] { 5 }
Constant [ integer BRAIN_WALLET_STILL_WEAK ] { 6 }
Constant [ integer BRAIN_WALLET_MAYBE_GOOD ] { 7 }
Constant [ integer BRAIN_WALLET_GOOD ] { 8 }
Constant [ integer BRAIN_WALLET_VERY_GOOD ] { 9 }
Constant [ integer BRAIN_WALLET_NICE ] { 10 }
Constant [ integer BRAIN_WALLET_PERFECT ] { 11 }
Constant [ integer VALUE_TO_SEND ] { 1 }
Constant [ integer VALUE_TO_RECEIVE ] { 2 }
Constant [ integer BALANCE_RAW_128 ] { 4 }
Constant [ integer BALANCE_REAL_STRING ] { 16 }
Constant [ integer BALANCE_RAW_STRING ] { 8 }
Constant [ integer VALUE_SEND_RECEIVE_RAW_128 ] { 32 }
Constant [ integer VALUE_SEND_RECEIVE_REAL_STRING ] { 128 }
Constant [ integer VALUE_SEND_RECEIVE_RAW_STRING ] { 64 }
Constant [ integer REP_XRB ] { 4 }
Constant [ integer SENDER_XRB ] { 2 }
Constant [ integer DEST_XRB ] { 1 }
Constant [ integer WORKER_FEE_HEX ] { 32 }
Constant [ integer WORKER_FEE_REAL ] { 128 }
Constant [ integer WORKER_FEE_RAW ] { 64 }
Constant [ integer PASS_MUST_HAVE_AT_LEAST_NONE ] { 0 }
Constant [ integer PASS_MUST_HAVE_AT_LEAST_ONE_NUMBER ] { 1 }
Constant [ integer PASS_MUST_HAVE_AT_LEAST_ONE_SYMBOL ] { 2 }
Constant [ integer PASS_MUST_HAVE_AT_LEAST_ONE_UPPER_CASE ] { 4 }
Constant [ integer PASS_MUST_HAVE_AT_LEAST_ONE_LOWER_CASE ] { 8 }
Constant [ integer PASS_IS_OUT_OVF ] { 1024 }
Constant [ integer PASS_IS_TOO_SHORT ] { 512 }
Constant [ integer PASS_IS_TOO_LONG ] { 256 }
Constant [ integer READ_SEED_FROM_STREAM ] { 1 }
Constant [ integer READ_SEED_FROM_FILE ] { 2 }
Constant [ integer MESSAGE_IS_DATA ] { 32 }
Constant [ integer MESSAGE_IS_BLOCK_HASH ] { 64 }
Constant [ integer MESSAGE_IS_BLOCK_HASH_STR ] { 128 }
}
- Functions {
Function [ <internal:mynanoembedded> function php_c_nano_check_sig ] {
- Parameters [3] {
Parameter #0 [ <required> $signature ]
Parameter #1 [ <required> $message ]
Parameter #2 [ <required> $nano_pk ]
}
}
Function [ <internal:mynanoembedded> function php_c_nano_proof_of_work ] {
- Parameters [3] {
Parameter #0 [ <required> $hash ]
Parameter #1 [ <required> $n_thr ]
Parameter #2 [ <optional> $threshold ]
}
}
Function [ <internal:mynanoembedded> function php_c_nano_verify_work ] {
- Parameters [3] {
Parameter #0 [ <required> $hash ]
Parameter #1 [ <required> $work ]
Parameter #2 [ <optional> $threshold ]
}
}
Function [ <internal:mynanoembedded> function php_c_nano_wallet_to_public_key ] {
- Parameters [1] {
Parameter #0 [ <required> $Nano ]
}
}
Function [ <internal:mynanoembedded> function php_c_public_key_to_nano_wallet ] {
- Parameters [2] {
Parameter #0 [ <required> $public_key ]
Parameter #1 [ <optional> $nano_prefix ]
}
}
Function [ <internal:mynanoembedded> function php_c_convert_balance ] {
- Parameters [2] {
Parameter #0 [ <required> $balance ]
Parameter #1 [ <required> $type ]
}
}
Function [ <internal:mynanoembedded> function php_c_generate_seed ] {
- Parameters [1] {
Parameter #0 [ <required> $entropy ]
}
}
Function [ <internal:mynanoembedded> function php_c_get_entropy_name ] {
- Parameters [1] {
Parameter #0 [ <required> $entropy ]
}
}
Function [ <internal:mynanoembedded> function php_c_nano_seed_to_bip39 ] {
- Parameters [2] {
Parameter #0 [ <required> $seed ]
Parameter #1 [ <required> $dictionary_path ]
}
}
Function [ <internal:mynanoembedded> function php_c_bip39_to_nano_seed ] {
- Parameters [2] {
Parameter #0 [ <required> $bip39 ]
Parameter #1 [ <required> $dictionary_path ]
}
}
Function [ <internal:mynanoembedded> function php_c_seed_to_nano_key_pair ] {
- Parameters [3] {
Parameter #0 [ <required> $seed ]
Parameter #1 [ <required> $wallet_number ]
Parameter #2 [ <optional> $prefix ]
}
}
Function [ <internal:mynanoembedded> function php_c_add_sub_balance ] {
- Parameters [3] {
Parameter #0 [ <required> $valueA ]
Parameter #1 [ <required> $valueB ]
Parameter #2 [ <required> $type ]
}
}
Function [ <internal:mynanoembedded> function php_c_compare ] {
- Parameters [4] {
Parameter #0 [ <required> $valueA ]
Parameter #1 [ <required> $valueB ]
Parameter #2 [ <required> $type ]
Parameter #3 [ <required> $compare ]
}
}
Function [ <internal:mynanoembedded> function php_c_brainwallet_generate ] {
- Parameters [4] {
Parameter #0 [ <required> $brainwallet ]
Parameter #1 [ <required> $salt ]
Parameter #2 [ <required> $mode ]
Parameter #3 [ <optional> $dictionary_path ]
}
}
Function [ <internal:mynanoembedded> function php_c_generate_token ] {
- Parameters [2] {
Parameter #0 [ <required> $data ]
Parameter #1 [ <required> $password ]
}
}
Function [ <internal:mynanoembedded> function php_c_verify_token ] {
- Parameters [3] {
Parameter #0 [ <required> $token ]
Parameter #1 [ <required> $data ]
Parameter #2 [ <required> $password ]
}
}
Function [ <internal:mynanoembedded> function php_c_license ] {
- Parameters [0] {
}
}
Function [ <internal:mynanoembedded> function php_c_library_info ] {
- Parameters [0] {
}
}
Function [ <internal:mynanoembedded> function php_c_to_multiplier ] {
- Parameters [2] {
Parameter #0 [ <required> $difficulty ]
Parameter #1 [ <required> $base_difficulty ]
}
}
Function [ <internal:mynanoembedded> function php_c_from_multiplier ] {
- Parameters [2] {
Parameter #0 [ <required> $multiplier ]
Parameter #1 [ <required> $base_difficulty ]
}
}
Function [ <internal:mynanoembedded> function php_c_generate_block ] {
- Parameters [9] {
Parameter #0 [ <required> $account ]
Parameter #1 [ <required> $previous ]
Parameter #2 [ <required> $representative ]
Parameter #3 [ <required> $balance ]
Parameter #4 [ <required> $balance_type ]
Parameter #5 [ <required> $val_send_rec ]
Parameter #6 [ <required> $val_send_rec_type ]
Parameter #7 [ <required> $link ]
Parameter #8 [ <required> $direction ]
}
}
Function [ <internal:mynanoembedded> function php_c_sign_block ] {
- Parameters [3] {
Parameter #0 [ <required> $user_block ]
Parameter #1 [ <required> $fee_block ]
Parameter #2 [ <required> $private_key ]
}
}
Function [ <internal:mynanoembedded> function php_c_get_account_from_block ] {
- Parameters [3] {
Parameter #0 [ <required> $block ]
Parameter #1 [ <optional> $type ]
Parameter #2 [ <optional> $prefix ]
}
}
Function [ <internal:mynanoembedded> function php_c_get_representative_from_block ] {
- Parameters [3] {
Parameter #0 [ <required> $block ]
Parameter #1 [ <optional> $type ]
Parameter #2 [ <optional> $prefix ]
}
}
Function [ <internal:mynanoembedded> function php_c_get_link_from_block ] {
- Parameters [3] {
Parameter #0 [ <required> $block ]
Parameter #1 [ <optional> $type ]
Parameter #2 [ <optional> $prefix ]
}
}
Function [ <internal:mynanoembedded> function php_c_get_previous_from_block ] {
- Parameters [1] {
Parameter #0 [ <required> $block ]
}
}
Function [ <internal:mynanoembedded> function php_c_get_balance_from_block ] {
- Parameters [2] {
Parameter #0 [ <required> $block ]
Parameter #1 [ <optional> $balance_type ]
}
}
Function [ <internal:mynanoembedded> function php_c_get_signature_from_block ] {
- Parameters [1] {
Parameter #0 [ <required> $block ]
}
}
Function [ <internal:mynanoembedded> function php_c_get_prefixes_from_block ] {
- Parameters [1] {
Parameter #0 [ <required> $block ]
}
}
Function [ <internal:mynanoembedded> function php_c_get_work_from_block ] {
- Parameters [1] {
Parameter #0 [ <required> $block ]
}
}
Function [ <internal:mynanoembedded> function php_c_set_account_to_block ] {
- Parameters [2] {
Parameter #0 [ <required> &$block ]
Parameter #1 [ <required> $wallet ]
}
}
Function [ <internal:mynanoembedded> function php_c_set_representative_to_block ] {
- Parameters [2] {
Parameter #0 [ <required> &$block ]
Parameter #1 [ <required> $representative ]
}
}
Function [ <internal:mynanoembedded> function php_c_set_link_to_block ] {
- Parameters [2] {
Parameter #0 [ <required> &$block ]
Parameter #1 [ <required> $link ]
}
}
Function [ <internal:mynanoembedded> function php_c_set_previous ] {
- Parameters [2] {
Parameter #0 [ <required> &$block ]
Parameter #1 [ <optional> $previous ]
}
}
Function [ <internal:mynanoembedded> function php_c_set_balance ] {
- Parameters [3] {
Parameter #0 [ <required> &$block ]
Parameter #1 [ <required> $balance ]
Parameter #2 [ <required> $balance_type ]
}
}
Function [ <internal:mynanoembedded> function php_c_set_signature ] {
- Parameters [2] {
Parameter #0 [ <required> &$block ]
Parameter #1 [ <required> $signature ]
}
}
Function [ <internal:mynanoembedded> function php_c_set_prefixes ] {
- Parameters [2] {
Parameter #0 [ <required> &$block ]
Parameter #1 [ <required> $prefixes ]
}
}
Function [ <internal:mynanoembedded> function php_c_set_work ] {
- Parameters [2] {
Parameter #0 [ <required> &$block ]
Parameter #1 [ <required> $work ]
}
}
Function [ <internal:mynanoembedded> function php_c_calculate_work_from_block ] {
- Parameters [3] {
Parameter #0 [ <required> &$block ]
Parameter #1 [ <required> $number_of_threads ]
Parameter #2 [ <optional> $threshold ]
}
}
Function [ <internal:mynanoembedded> function php_c_parse_block_to_json ] {
- Parameters [1] {
Parameter #0 [ <required> $block ]
}
}
Function [ <internal:mynanoembedded> function php_c_get_block_hash ] {
- Parameters [1] {
Parameter #0 [ <required> $block ]
}
}
Function [ <internal:mynanoembedded> function php_c_block_to_p2pow ] {
- Parameters [5] {
Parameter #0 [ <required> $block ]
Parameter #1 [ <required> $worker_wallet ]
Parameter #2 [ <required> $worker_representative ]
Parameter #3 [ <required> $worker_fee ]
Parameter #4 [ <optional> $worker_fee_type ]
}
}
Function [ <internal:mynanoembedded> function php_c_p2pow_to_json ] {
- Parameters [1] {
Parameter #0 [ <required> $block ]
}
}
Function [ <internal:mynanoembedded> function php_c_sign_p2pow_block ] {
- Parameters [2] {
Parameter #0 [ <required> &$p2pow_block ]
Parameter #1 [ <required> $private_key ]
}
}
Function [ <internal:mynanoembedded> function php_c_get_difficulty ] {
- Parameters [3] {
Parameter #0 [ <required> $hash ]
Parameter #1 [ <required> $work ]
Parameter #2 [ <optional> $threshold ]
}
}
Function [ <internal:mynanoembedded> function php_c_gen_seed_to_encrypted_stream ] {
- Parameters [5] {
Parameter #0 [ <required> $entropy ]
Parameter #1 [ <required> $password ]
Parameter #2 [ <required> $password_min_len ]
Parameter #3 [ <required> $password_max_len ]
Parameter #4 [ <optional> $password_type ]
}
}
Function [ <internal:mynanoembedded> function php_c_gen_encrypted_stream_to_seed ] {
- Parameters [3] {
Parameter #0 [ <required> $encrypted_stream ]
Parameter #1 [ <required> $password ]
Parameter #2 [ <required> $dictionary_file ]
}
}
Function [ <internal:mynanoembedded> function php_c_is_valid_nano_seed_encrypted ] {
- Parameters [2] {
Parameter #0 [ <required> $encrypted_stream ]
Parameter #1 [ <optional> $read_from ]
}
}
Function [ <internal:mynanoembedded> function php_c_bip39_to_nano_key_pair ] {
- Parameters [4] {
Parameter #0 [ <required> $bip39 ]
Parameter #1 [ <required> $dictionary_path ]
Parameter #2 [ <required> $wallet_number ]
Parameter #3 [ <optional> $prefix ]
}
}
Function [ <internal:mynanoembedded> function php_c_brainwallet_to_nano_key_pair ] {
- Parameters [5] {
Parameter #0 [ <required> $brainwallet ]
Parameter #1 [ <required> $salt ]
Parameter #2 [ <required> $mode ]
Parameter #3 [ <required> $wallet_number ]
Parameter #4 [ <optional> $prefix ]
}
}
Function [ <internal:mynanoembedded> function php_c_encrypted_stream_to_key_pair ] {
- Parameters [4] {
Parameter #0 [ <required> $encrypted_stream ]
Parameter #1 [ <required> $password ]
Parameter #2 [ <required> $wallet_number ]
Parameter #3 [ <optional> $prefix ]
}
}
Function [ <internal:mynanoembedded> function php_c_bip39_to_encrypted_stream ] {
- Parameters [6] {
Parameter #0 [ <required> $bip39 ]
Parameter #1 [ <required> $dictionary ]
Parameter #2 [ <required> $password ]
Parameter #3 [ <required> $password_min_len ]
Parameter #4 [ <required> $password_max_len ]
Parameter #5 [ <optional> $password_type ]
}
}
Function [ <internal:mynanoembedded> function php_c_brainwallet_to_encrypted_stream ] {
- Parameters [7] {
Parameter #0 [ <required> $brainwallet ]
Parameter #1 [ <required> $salt ]
Parameter #2 [ <required> $allow_mode ]
Parameter #3 [ <required> $password ]
Parameter #4 [ <required> $password_min_len ]
Parameter #5 [ <required> $password_max_len ]
Parameter #6 [ <optional> $password_type ]
}
}
Function [ <internal:mynanoembedded> function php_c_sign_message ] {
- Parameters [3] {
Parameter #0 [ <required> $message ]
Parameter #1 [ <required> $private_key ]
Parameter #2 [ <optional> $type ]
}
}
Function [ <internal:mynanoembedded> function php_c_check_message_sig ] {
- Parameters [4] {
Parameter #0 [ <required> $signature ]
Parameter #1 [ <required> $message ]
Parameter #2 [ <required> $publickey ]
Parameter #3 [ <optional> $type ]
}
}
}
- Classes [1] {
Class [ <internal:mynanoembedded> class MyNanoCEmbeddedException extends Exception implements Throwable ] {
- Constants [0] {
}
- Static properties [0] {
}
- Static methods [0] {
}
- Properties [4] {
Property [ <default> protected $message ]
Property [ <default> protected $code ]
Property [ <default> protected $file ]
Property [ <default> protected $line ]
}
- Methods [10] {
Method [ <internal:Core, inherits Exception, ctor> public method __construct ] {
- Parameters [3] {
Parameter #0 [ <optional> $message ]
Parameter #1 [ <optional> $code ]
Parameter #2 [ <optional> $previous ]
}
}
Method [ <internal:Core, inherits Exception> public method __wakeup ] {
}
Method [ <internal:Core, inherits Exception, prototype Throwable> final public method getMessage ] {
}
Method [ <internal:Core, inherits Exception, prototype Throwable> final public method getCode ] {
}
Method [ <internal:Core, inherits Exception, prototype Throwable> final public method getFile ] {
}
Method [ <internal:Core, inherits Exception, prototype Throwable> final public method getLine ] {
}
Method [ <internal:Core, inherits Exception, prototype Throwable> final public method getTrace ] {
}
Method [ <internal:Core, inherits Exception, prototype Throwable> final public method getPrevious ] {
}
Method [ <internal:Core, inherits Exception, prototype Throwable> final public method getTraceAsString ] {
}
Method [ <internal:Core, inherits Exception, prototype Throwable> public method __toString ] {
}
}
}
}
}
Donation are welcome :)
| Coin | Wallet |
|---|---|
| Bitcoin: | 1JDckpLRJGhp46LTcjY1vsW19wurZ3L1d5 |
| Nano: | nano_1cb5fs7xmixqzpitfn9ouy4j1g3hjmdfudc1igt5xhwwps7qdku5htqxmznb |
| Litecoin: | LRjEiKadFzPCoGorWvSVUnWPsFyPZGt97f |
| Dogecoin: | DRrWWMdwY6AN8rdz7zH2cp3qaK8vSgDTau |
This project is under MIT license see LICENSE
You can contact me at [email protected] or [email protected]