thesuperiorcoin/superior-php

用于Superior simplewallet JSON-RPC接口的PHP库。

v1.0 2018-03-04 05:56 UTC

This package is not auto-updated.

Last update: 2024-09-21 13:54:50 UTC


README

用于Superior simplewallet JSON-RPC接口的PHP库。

有关Superior的更多信息,请访问https://getmonero.org/home

如果您觉得这个工具有用,请随意捐赠!

SUP: 5QaiHzo64sLDo42ky98uXtJ3zswCdpUrk1q5nSidtqovjjiC7FmxRt84Zu3HkpYQX1PLDU72aQMK6Cif4muRxwt3RyZXY6y

安装

使用Composer安装库。

composer require thesuperiorcoin/superior-php

创建钱包实例

require 'vendor/autoload.php';
use Superior\Wallet;

$wallet = new Superior\Wallet();

默认主机名和端口连接到http://127.0.0.1:16036

要连接到外部IP或不同的端口

$hostname = YOUR_WALLET_IP;
$port = YOUR_WALLET_PORT;
$wallet = new Superior\Wallet($hostname, $port);

钱包方法

getBalance

$balance = $wallet->getBalance();

返回钱包当前的余额和未锁定(可花费)余额,以原子单位表示。除以1e8进行转换。

示例响应

{ balance: 3611980142579999, unlocked_balance: 3611980142579999 }

getAddress

$address = $wallet->getAddress();

返回钱包的Superior地址。

示例响应

{ address: '5QaiHzo64sLDo42ky98uXtJ3zswCdpUrk1q5nSidtqovjjiC7FmxRt84Zu3HkpYQX1PLDU72aQMK6Cif4muRxwt3RyZXY6y' }

transfer

$tx_hash = $wallet->transfer($options);

将Superior转给单个收款人或者一个收款人组,在一个交易中。返回付款的交易哈希。

参数

  • options - 包含 destinations (对象或对象数组), mixin (int), unlock_time (int), payment_id (string) 的数组。必须提供 destinations。默认mixin值为4。
$options = [
    'destinations' => (object) [
        'amount' => '1',
        'address' => '5QaiHzo64sLDo42ky98uXtJ3zswCdpUrk1q5nSidtqovjjiC7FmxRt84Zu3HkpYQX1PLDU72aQMK6Cif4muRxwt3RyZXY6y'
    ]
];

示例响应

{ tx_hash: '<a38140b8a6cfd0c8de6b7fe8f83fb2f5ae0f0eec50f6221fefc871649e7b3c68>', tx_key: '' }

transferSplit

$tx_hash = $wallet->transferSplit($options);

transfer() 相同,但必要时可以拆分成多个交易。返回交易哈希列表。

对于 options 数组可用的附加属性

  • new_algorithm - 使用新的交易构建算法为 true,默认为 false。(布尔值)

示例响应

{ tx_hash_list: [ '<a38140b8a6cfd0c8de6b7fe8f83fb2f5ae0f0eec50f6221fefc871649e7b3c68>' ] }

sweepDust

$tx_hashes = $wallet->sweepDust();

将所有零散输出发送回钱包,以便更容易花费和混合资金。返回相应的交易哈希列表。

示例响应

{ tx_hash_list: [ '<a38140b8a6cfd0c8de6b7fe8f83fb2f5ae0f0eec50f6221fefc871649e7b3c68>' ] }

getPayments

$payments = $wallet->getPayments($payment_id);

返回使用给定付款ID的收到的付款列表。

参数

  • paymentID - 要扫描钱包中包含的交易(字符串)的付款ID

getBulkPayments

$payments = $wallet->getBulkPayments($payment_id, $height);

返回使用单个付款ID或给定高度的付款ID列表的收到的付款列表。

参数

  • paymentIDs - 要扫描钱包中(数组)的付款ID或ID列表
  • minHeight - 从开始扫描的最小区块高度(例如:800000)(整数

incomingTransfers

$transfers = $wallet->incomingTransfers($type);

返回钱包的收到的转账列表。

参数

  • type - 接受 "all":所有转账,"available":尚未花费的转账,或 "unavailable":已花费的转账(《字符串》)

queryKey

$key = $wallet->queryKey($type);

返回钱包的消费密钥(助记词种子)或查看私钥。

参数

  • type - 接受 "mnemonic":用于恢复钱包的助记词种子,或 "view_key":钱包的查看密钥(《字符串》)

integratedAddress

$integratedAddress = $wallet->integratedAddress($payment_id);

从您的钱包地址和给定的付款ID创建并返回一个新的集成地址,或者如果没有提供,则自动生成一个随机付款ID。

参数

  • payment_id - 64字符十六进制字符串。如果没有提供,将自动生成随机付款ID。(字符串,可选

示例响应

{ integrated_address: '5QaiHzo64sLDo42ky98uXtJ3zswCdpUrk1q5nSidtqovjjiC7FmxRt84Zu3HkpYQX1PLDU72aQMK6Cif4muRxwt3RyZXY6y' }

splitIntegrated

$splitIntegrated = $wallet->splitIntegrated($integrated_address);

返回给定集成地址对应的标准地址和付款ID。

参数

  • integrated_address - 一个高级集成地址(字符串

示例响应

{ payment_id: '<61eec5ffd3b9cb57>',
  standard_address: '5QaiHzo64sLDo42ky98uXtJ3zswCdpUrk1q5nSidtqovjjiC7FmxRt84Zu3HkpYQX1PLDU72aQMK6Cif4muRxwt3RyZXY6y' }

getHeight

用法

$height = $wallet->getHeight();

返回守护进程当前区块高度。

示例响应

{ height: 874458 }

stopWallet

$wallet->stopWallet();

干净地关闭当前simplewallet进程。

简介

这是superior-wallet-rpc调用列表,它们的输入和输出,以及每个的示例。程序superior-wallet-rpc取代了simplewallet和superior-wallet-cli中的rpc接口。所有superior-wallet-rpc方法都使用相同的JSON RPC接口。例如

IP=127.0.0.1
PORT=16036
METHOD="make_integrated_address"
PARAMS="{\"payment_id\":\"1234567890123456789012345678900012345678901234567890123456789000\"}"
curl \
    -X POST http://$IP:$PORT/json_rpc \
    -d '{"jsonrpc":"2.0","id":"0","method":"'$METHOD'","params":'"$PARAMS"'}' \
    -H 'Content-Type: application/json'

如果superior-wallet-rpc以--rpc-login参数执行为username:password,则按此示例

IP=127.0.0.1
PORT=16036
METHOD="make_integrated_address"
PARAMS="{\"payment_id\":\"1234567890123456789012345678900012345678901234567890123456789000\"}"
curl \
    -u username:password --digest \
    -X POST http://$IP:$PORT/json_rpc \
    -d '{"jsonrpc":"2.0","id":"0","method":"'$METHOD'","params":'"$PARAMS"'}' \
    -H 'Content-Type: application/json'

注意:“原子单位”指根据superiord实现,1 SUP的最小分数。1 SUP = 1e8原子单位。

JSON RPC方法索引

•	getbalance
•	getaddress
•	getheight
•	transfer
•	transfer_split
•	sweep_dust
•	store
•	get_payments
•	get_bulk_payments
•	get_transfers
•	incoming_transfers
•	query_key
•	make_integrated_address
•	split_integrated_address
•	stop_wallet

JSON RPC方法

getbalance

返回钱包的余额。输入:无。输出:• balance - 无符号整数;当前Superior-wallet-rpc会话的总余额。• unlocked_balance - 无符号整数;未锁定资金是指足够深入到Superior区块链中的资金,可以被认为安全支出的资金。

示例

[ superior->~ ]$ curl -X POST http://127.0.0.1:16036/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"getbalance"}' -H 'Content-Type: application/json' { "id": "0", "jsonrpc": "2.0", "result": { "balance": 140000000000, "unlocked_balance": 50000000000 } }
getaddress

返回钱包的地址。输入:无。输出

•	address - string; The 95-character hex address string of the superior-wallet-rpc in session.

示例

[ superior->~ ]$ curl -X POST http://127.0.0.1:16036/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"getaddress"}' -H 'Content-Type: application/json' { "id": "0", "jsonrpc": "2.0", "result": { "address": "5QaiHzo64sLDo42ky98uXtJ3zswCdpUrk1q5nSidtqovjjiC7FmxRt84Zu3HkpYQX1PLDU72aQMK6Cif4muRxwt3RyZXY6y" } }
getheight

返回钱包的当前区块高度。输入:无。输出:• height - 字符串;当前superior-wallet-rpc的区块链高度。如果钱包已离线很长时间,它可能需要与守护进程同步。

示例

[ superior->~ ]$ curl -X POST http://127.0.0.1:16036/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"getheight"}' -H 'Content-Type: application/json' { "id": "0", "jsonrpc": "2.0", "result": { "height": 994310 } }
transfer

将superior发送给多个收款人。

输入:• destinations - 要接收Sup的接收地址数组:◦ amount - 无符号整数;发送到每个目的地的金额,以原子单位计。◦ address - 字符串;目的公共地址。• fee - 无符号整数;忽略,将自动计算。• mixin - 无符号整数;从区块链中混合输出的数量(0表示不混合)。• unlock_time - 无符号整数;在superior可以花费之前要等待的区块数量(0表示不添加锁定)。• payment_id - 字符串;(可选)用于识别交易的随机32字节/64字符十六进制字符串。• get_tx_key - 布尔值;(可选)在发送后返回交易密钥。输出:
• fee - 记录费用的整数值。• tx_hash - 公开可搜索的交易哈希字符串。• tx_key - 如果get_tx_key为true,则为交易密钥字符串,否则为空字符串。

示例

[ superior->~ ]$ curl -X POST http://127.0.0.1:16036/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"transfer","params":{"destinations":[{"amount":100000000,"address":"5QaiHzo64sLDo42ky98uXtJ3zswCdpUrk1q5nSidtqovjjiC7FmxRt84Zu3HkpYQX1PLDU72aQMK6Cif4muRxwt3RyZXY6y"},{"amount":200000000,"address":"5QaiHzo64sLDo42ky98uXtJ3zswCdpUrk1q5nSidtqovjjiC7FmxRt84Zu3HkpYQX1PLDU72aQMK6Cif4muRxwt3RyZXY6y"}],"mixin":4,"get_tx_key": true}}' -H 'Content-Type: application/json' { "id": "0", "jsonrpc": "2.0", "result": { "fee": 48958481211, "tx_hash": "a38140b8a6cfd0c8de6b7fe8f83fb2f5ae0f0eec50f6221fefc871649e7b3c68", "tx_key": "a38140b8a6cfd0c8de6b7fe8f83fb2f5ae0f0eec50f6221fefc871649e7b3c68" } }
transfer_split

与transfer相同,但必要时可以拆分为多个tx。

输入:• destinations - 要接收Sup的接收地址数组:◦ amount - 无符号整数;发送到每个目的地的金额,以原子单位计。◦ address - 字符串;目的公共地址。• fee - 无符号整数;忽略,将自动计算。• mixin - 无符号整数;从区块链中混合输出的数量(0表示不混合)。• unlock_time - 无符号整数;在superior可以花费之前要等待的区块数量(0表示不添加锁定)。• payment_id - 字符串;(可选)用于识别交易的随机32字节/64字符十六进制字符串。• get_tx_key - 布尔值;(可选)在发送后返回交易密钥。- 被忽略• new_algorithm - 布尔值;如果为true,则使用新的交易构造算法,默认为false。

输出:• fee_list - 数组:整数• tx_hash_list - 数组:字符串

示例

[ superior->~ ]$ curl -X POST http://127.0.0.1:16036/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"transfer_split","params":{"destinations":[{"amount":100000000,"address":"5wNgSYy2F9qPZu7KBjvsFgZLTKE2TZgEpNFbGka9gA5zPmAXS35QzzYaLKJRkYTnzgArGNX7TvSqZC87tBwtaC5RQgJ8rm"},{"amount":200000000,"address":"5vH5D7Fv47mbpCpdcthcjU34rqiiAYRCh1tYywmhqnEk9iwCE9yppgNCXAyVHG5qJt2kExa42TuhzQfJbmbpeGLkVbg8xit"},{"amount":200000000,"address":"5vC5Q25cR1d3WzKX6dpTaLJaqZyDrtTnfadTmVuB1Wue2tyFGxUhiE4RGa74pEDJv7gSySzcd1Ao6G1nzSaqp78vLfP6MPj"},{"amount":200000000,"address":"52MSrn49ziBPJBh8ZNEhhbfyLMou6mao4C1F5TLGUatmUnCxZArDYkcbAnVkVEopWVeak2rKDrmc8JpoS7n5dvfN9YDPBTG"},{"amount":200000000,"address":"5tEDyVQ8zgRQbDYiykTdpw5kZ6qWQWcKfExEj9eQshjpGb3sdr3UyWE2AHWzUGzJjaH9HN1DdGBdyQQ4AqGMc7rr5xYwZWW"}],"mixin":4,"get_tx_key": true, "new_algorithm": true}}' -H 'Content-Type: application/json' { "id": "0", "jsonrpc": "2.0", "result": { "fee_list": [97916962422], "tx_hash_list": ["c5c389846e701c27aaf1f7ab8b9dc457b471fcea5bc9710e8020d51275afbc54"] } }
sweep_dust

将所有灰尘输出送回钱包,以便更容易花费(并且混合)。输入:无。输出

•	tx_hash_list - list of: string

示例(在这个示例中,sweep_dust由于清零资金不足而返回错误)

[ superior->~ ]$ curl -X POST http://127.0.0.1:16036/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"sweep_dust"}' -H 'Content-Type: application/json' { "error": { "code": -4, "message": "not enough money" }, "id": "0", "jsonrpc": "2.0" }
store

保存区块链。输入:无。输出:无。

示例

[ superior->~ ]$ curl -X POST http://127.0.0.1:16036/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"store"}' -H 'Content-Type: application/json' { "id": "0", "jsonrpc": "2.0", "result": { } }
get_payments

使用给定的支付ID获取使用中的付款列表。

输入:• payment_id - 字符串 输出:• payments - 列表:◦ payment_id - 字符串 ◦ tx_hash - 字符串 ◦ amount - 无符号整数 ◦ block_height - 无符号整数 ◦ unlock_time - 无符号整数

示例

[ superior->~ ]$ curl -X POST http://127.0.0.1:16036/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"get_payments","params":{"payment_id":"4279257e0a20608e25dba8744949c9e1caff4fcdafc7d5362ecf14225f3d9030"}}' -H 'Content-Type: application/json' { "id": "0", "jsonrpc": "2.0", "result": { "payments": [{ "amount": 10350000000000, "block_height": 994327, "payment_id": "4279257e0a20608e25dba8744949c9e1caff4fcdafc7d5362ecf14225f3d9030", "tx_hash": "c391089f5b1b02067acc15294e3629a463412af1f1ed0f354113dd4467e4f6c1", "unlock_time": 0 }] } }
get_bulk_payments

使用给定的支付ID或支付ID列表,从给定的高度获取付款列表。此方法比get_payments方法更受欢迎,因为它具有相同的功能,但更具可扩展性。两者都可以用于按单个支付ID查找交易。

输入:• payment_ids - 字符串数组;• min_block_height - 无符号整数;查找支付的起始区块高度。输出:• payments - 列表:◦ payment_id - 字符串 ◦ tx_hash - 字符串 ◦ amount - 无符号整数 ◦ block_height - 无符号整数 ◦ unlock_time - 无符号整数

示例

[ superior->~ ]$ curl -X POST http://127.0.0.1:16036/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"get_bulk_payments","params":{"payment_ids":["4279257e0a20608e25dba8744949c9e1caff4fcdafc7d5362ecf14225f3d9030"],"min_block_height":990000}}' -H 'Content-Type: application/json' { "id": "0", "jsonrpc": "2.0", "result": { "payments": [{ "amount": 10350000000000, "block_height": 994327, "payment_id": "4279257e0a20608e25dba8744949c9e1caff4fcdafc7d5362ecf14225f3d9030", "tx_hash": "c391089f5b1b02067acc15294e3629a463412af1f1ed0f354113dd4467e4f6c1", "unlock_time": 0 }] } }
get_transfers

返回一个转账列表。

输入:• in - 布尔值;• out - 布尔值;• pending - 布尔值;• failed - 布尔值;• pool - 布尔值;• filter_by_height - 布尔值;• min_height - 无符号整数;• max_height - 无符号整数;输出:• in - 转账数组:◦ txid - 字符串;◦ payment_id - 字符串;◦ height - 无符号整数;◦ timestamp - 无符号整数;◦ amount - 无符号整数;◦ fee - 无符号整数;◦ note - 字符串;◦ destinations - std::list;◦ type - 字符串;• out - 转账数组;• pending - 转账数组;• failed - 转账数组;• pool - 转账数组

示例

[ superior->~ ]$ curl -X POST http://127.0.0.1:16036/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"get_transfers","params":{"pool":true}}' -H 'Content-Type: application/json' { "id": "0", "jsonrpc": "2.0", "result": { "pool": [{ "amount": 500000000000, "fee": 0, "height": 0, "note": "", "payment_id": "758d9b225fda7b7f", "timestamp": 1488312467, "txid": "da7301d5423efa09fabacb720002e978d114ff2db6a1546f8b820644a1b96208", "type": "pool" }] } }
incoming_transfers

返回钱包的接收转账列表。

输入:• transfer_type - 字符串;"all": 所有转账,"available": 尚未使用的转账,或者"unavailable": 已经使用的转账。输出:• transfers - 列表:◦ amount - 无符号整数 ◦ spent - 布尔值 ◦ global_index - 无符号整数;主要用于内部使用,大多数用户可以忽略。◦ tx_hash - 字符串;如果多个接收转账在同一笔交易中,则可能共享相同的哈希值。◦ tx_size - 无符号整数

示例(返回所有交易类型)

[ superior->~ ]$ curl -X POST http://127.0.0.1:16036/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"incoming_transfers","params":{"transfer_type":"all"}}' -H 'Content-Type: application/json' { "id": "0", "jsonrpc": "2.0", "result": { "transfers": [{ "amount": 10000000000000, "global_index": 711506, "spent": false, "tx_hash": "<c391089f5b1b02067acc15294e3629a463412af1f1ed0f354113dd4467e4f6c1>", "tx_size": 5870 },{ "amount": 300000000000, "global_index": 794232, "spent": false, "tx_hash": "<c391089f5b1b02067acc15294e3629a463412af1f1ed0f354113dd4467e4f6c1>", "tx_size": 5870 },{ "amount": 50000000000, "global_index": 213659, "spent": false, "tx_hash": "<c391089f5b1b02067acc15294e3629a463412af1f1ed0f354113dd4467e4f6c1>", "tx_size": 5870 }] } }

示例(返回可用交易)

[ superior->~ ]$ curl -X POST http://127.0.0.1:16036/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"incoming_transfers","params":{"transfer_type":"available"}}' -H 'Content-Type: application/json' { "id": "0", "jsonrpc": "2.0", "result": { "transfers": [{ "amount": 10000000000000, "global_index": 711506, "spent": false, "tx_hash": "<c391089f5b1b02067acc15294e3629a463412af1f1ed0f354113dd4467e4f6c1>", "tx_size": 5870 },{ "amount": 300000000000, "global_index": 794232, "spent": false, "tx_hash": "<c391089f5b1b02067acc15294e3629a463412af1f1ed0f354113dd4467e4f6c1>", "tx_size": 5870 },{ "amount": 50000000000, "global_index": 213659, "spent": false, "tx_hash": "<c391089f5b1b02067acc15294e3629a463412af1f1ed0f354113dd4467e4f6c1>", "tx_size": 5870 }] } }

示例(返回不可用交易。注意,这个特定的示例返回0个不可用交易)

[ superior->~ ]$ curl -X POST http://127.0.0.1:16036/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"incoming_transfers","params":{"transfer_type":"unavailable"}}' -H 'Content-Type: application/json' { "id": "0", "jsonrpc": "2.0", "result": { } }
query_key

返回消费或查看私钥。输入:• key_type - 字符串;要检索的密钥:"mnemonic" - 密码种子(旧钱包没有)或者"view_key" - 查看密钥。输出:• key - 字符串;查看密钥将以十六进制编码,而密码种子将是一系列单词。

示例(查询查看密钥)

[ superior->~ ]$ curl -X POST http://127.0.0.1:16036/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"query_key","params":{"key_type":"view_key"}}' -H 'Content-Type: application/json' { "id": "0", "jsonrpc": "2.0", "result": { "key": "7e341d…" } }

示例(查询密码种子密钥)

[ superior->~ ]$ curl -X POST http://127.0.0.1:16036/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"query_key","params":{"key_type":"mnemonic"}}' -H 'Content-Type: application/json' { "id": "0", "jsonrpc": "2.0", "result": { "key": "adapt adapt nostril …" } }
make_integrated_address

从钱包地址和支付ID生成一个集成地址。

输入:• payment_id - 字符串;十六进制编码;可以为空,在这种情况下将生成一个随机的支付ID。输出:• integrated_address - 字符串

示例(支付ID为空,使用随机ID)

[ superior->~ ]$ curl -X POST http://127.0.0.1:16036/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"make_integrated_address","params":{"payment_id":""}}' -H 'Content-Type: application/json' { "id": "0", "jsonrpc": "2.0", "result": { "integrated_address": "5BpEv3WrufwXoyJAeEoBaNW56ScQaLXyyQWgxeRL9KgAUhVzkvfiELZV7fCPBuuB2CGuJiWFQjhnhhwiH1FsHYGQQ8H2RRJveAtUeiFs6J" } }
split_integrated_address

检索对应于集成地址的标准地址和支付ID。

输入:• integrated_address - 字符串。输出:• standard_address - 字符串;• payment - 字符串;十六进制编码

示例

[ superior->~ ]$ curl -X POST http://127.0.0.1:16036/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"split_integrated_address","params":{"integrated_address": "5BpEv3WrufwXoyJAeEoBaNW56ScQaLXyyQWgxeRL9KgAUhVzkvfiELZV7fCPBuuB2CGuJiWFQjhnhhwiH1FsHYGQQ8H2RRJveAtUeiFs6J"}}' -H 'Content-Type: application/json' { "id": "0", "jsonrpc": "2.0", "result": { "payment_id": "<420fa29b2d9a49f5>", "standard_address": "527ZuEhNJQRXoyJAeEoBaNW56ScQaLXyyQWgxeRL9KgAUhVzkvfiELZV7fCPBuuB2CGuJiWFQjhnhhwiH1FsHYGQGaDsaBA" } }
stop_wallet

停止钱包,存储当前状态。

输入:无。输出:无。

示例

[ superior->~ ]$ curl -X POST http://127.0.0.1:16036/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"stop_wallet"}' -H 'Content-Type: application/json' { "id": "0", "jsonrpc": "2.0", "result": { } }
make_uri

使用官方URI规范创建一个支付URI。

输入:• address - 钱包地址字符串;• amount(可选) - 接收的整数金额,以原子单位计算;• payment_id(可选) - 16或64字符的十六进制支付ID字符串;• recipient_name(可选) - 支付接收者的字符串姓名;• tx_description(可选) - 描述交易原因的字符串。输出:• uri - 包含所有支付输入信息的字符串,格式正确的支付URI。

示例

[ superior->~ ]$curl -X POST http://127.0.0.1:16036/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"make_uri","params":{"address":"54AFFq5kSiGBoZ4NMDwYtN18obc8AemS33DBLWs3H7otXft3XjrpDtQGv7SqSsaBYBb98uNbr2VBBEt7f2wfn3RVGQBEP3A","amount":10,"payment_id":"0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef","tx_description":"Testing out the make_uri function.","recipient_name":"Superior Project donation address"}}' -H 'Content-Type: application/json' { "id": 0, "jsonrpc": "2.0", "result": { "uri": "superior:54AFFq5kSiGBoZ4NMDwYtN18obc8AemS33DBLWs3H7otXft3XjrpDtQGv7SqSsaBYBb98uNbr2VBBEt7f2wfn3RVGQBEP3A?tx_payment_id=0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef&tx_amount=0.000000000010&recipient_name=Superior%20Project%20donation%20address&tx_description=Testing%20out%20the%20make_uri%20function." } }
parse_uri

解析支付URI以获取支付信息。

输入:• uri - 包含所有支付输入信息的字符串,格式正确的支付URI。输出:• uri - 包含支付信息的JSON对象:◦ address - 钱包地址字符串 ◦ amount - 接收的十进制金额,以币单位计算(如果没有提供则为0) ◦ payment_id - 16或64字符的十六进制支付ID字符串(如果没有提供则为空) ◦ recipient_name - 支付接收者的字符串姓名(如果没有提供则为空) ◦ tx_description - 描述交易原因的字符串(如果没有提供则为空)

示例

[ superior->~ ]$curl -X POST http://127.0.0.1:16036/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"parse_uri","params":{"uri":"superior:44AFFq5kSiGBoZ4NMDwYtN18obc8AemS33DBLWs3H7otXft3XjrpDtQGv7SqSsaBYBb98uNbr2VBBEt7f2wfn3RVGQBEP3A?tx_payment_id=0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef&tx_amount=0.000000000010&recipient_name=Superior%20Project%20donation%20address&tx_description=Testing%20out%20the%20make_uri%20function."}}' -H 'Content-Type: application/json' { "id": 0, "jsonrpc": "2.0", "result": { "uri": { "address": "54AFFq5kSiGBoZ4NMDwYtN18obc8AemS33DBLWs3H7otXft3XjrpDtQGv7SqSsaBYBb98uNbr2VBBEt7f2wfn3RVGQBEP3A", "amount": 10, "payment_id": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef", "recipient_name": "Superior Project donation address", "tx_description": "Testing out the make_uri function." } } }