solana/durable-nonce.md at b03186e3c650cd367554155ef9373e3573dcac4f

Files

mergify[bot] b03186e3c6 Add chinese translations to docs (#17125 ) (#17127 )

* import zh translations

* Fix broken links

* fix whitespace

(cherry picked from commit a1df57a4ea)

Co-authored-by: Justin Starry <justin@solana.com>

2021-05-08 17:09:51 +00:00

6.4 KiB

Raw Blame History

title

title
持久交易随机数（Nonces）

持久交易随机数是一个机制，它可以绕过交易典型的个短寿期 recent_blockhash。这些方案是作为Solana方案实施的，其机制详见 proposal。

使用示例

持久的 nonce CLI 命令的详细使用情况可在 CLI 引用中找到。

Nonce 授权

可以将对临时帐户的权限分配给另一个帐户。这样，新授权机构将继承先前的授权机构（包括帐户创建者）对临时帐户的完全控制权。通过此功能，可以创建更复杂的帐户的所有权安排以及与密钥对无关的派生帐户地址。 --nonce-authority <AUTHORITY_KEYPAIR> 参数用于指定此帐户，并且受以下命令：

create-nonce-account
new-nonce
withdraw-from-nonce-account
authorize-nonce-account

Nonce 帐户创建

持久性交易随机数功能使用一个帐户来存储下一个随机数值。持久的现时帐户必须为免租，因此需要最低余额才能实现此目的。

通过首次生成一个新的密钥对，然后在链上创建该帐户来创建一个 nonce 帐户。

命令

solana-keygen new -o nonce-keypair.json
solana create-nonce-account nonce-keypair.json 1

输出

2SymGjGV4ksPdpbaqWFiDoBz8okvtiik4KE9cnMQgRHRLySSdZ6jrEcpPifW4xUpp4z66XM9d9wM48sA7peG2XL

查询存储Nonce值

创建持久的随机数交易需要在签名和提交时将存储的随机数值作为值传递给--blockhash参数。使用以下方法获取当前存储的当前值：

命令

solana nonce none-non-keypair.json

输出

8GRipryfxcsxN8mAGjy8zbFo9ezaUsh47TsPzmZbuytU

提升存储Nonce值

尽管通常不需要在更有用的交易之外进行存储，但存储的当前值可以通过以下方式获取：

命令

solana new-nonce none-non-keypair.json

输出

44jYe1yPKrjuYDmoFTdgPjg8LFpYyh1PFKJqm5SC1PiSyAL8iw1bhadcAX1SL7KDmREEkmHpYvreKoNv6fZgfvUK

显示Nonce账户

以更人性化的格式检查nonce 帐户

命令

solana non-account non-ceypair.json

输出

balance: 0.5 SOL
minimum balance required: 0.00136416 SOL
nonce: DZar6t2EaCFQTbUP4DHKwZ1wT8gCPW2aRfkVWhydkBvS

从Nonce帐号提取资产

通过以下方式从 nonce 帐户提取资产

命令

solana withdraw-from-nonce-account nonce-keypair.json ~/.config/solana/id.json 0.5

输出

3foNy1SBqwXSsfSfTdmYKDuhnVheRnKXpoPySiUDBVeDEs6iMVokgqm7AqfTjbk7QBE8mqomvMUMNQhtdMvFLide

为Nonce账户分配新的授权

创建后重新分配 nonce 帐户的授权

命令

solana authorize-non-account non-keypair.json nonce-authority.json

输出

3F9cg4zN9wHxLGx4c3cUKmqpej4oa67QbALmChsJbfxTgTffRiL3iUehVhR9wQmWgPua66jPuAYeL1K2pYYjbNoT

支持持久Nonce的其他命令

要将持久随机数与其他CLI子命令一起使用，必须支持两个参数。

--nonce，指定帐户存储 nonce 值
--nonce-authority，指定一个可选的 nonce authority

到目前为止，以下子命令已接受此处理

使用持久Nonce的支付示例

在这里，我们演示了Alice使用持久 nonce 向Bob 1 SOL支付的费用。对于支持持久随机数的所有子命令，该过程相同

- 创建帐户

首先，我们需要为Alice、Alice的none和Bob准备一些账户

$ solana-keygen new -o alice.json
$ solana-keygen new -o nonce.json
$ solana-keygen new -o bob.json

- Alice账户充值

Alice 需要一些资产来创建一个 nonce 帐户并发送给 Bob。空投一些SOL给她

$ solana airdrop -k alice.json 10
10 SOL

- 创建 Alice 的 nonce 帐户

现在Alice需要一个nonce 帐户。创建一个

$ solana create-nonce-account -k alice.json nonce.json 1
3KPZr96BTsL3hqera9up82KAU462Gz31xjqJ6ehuAjF935Yf8i1kmfEbo6SVbNaACKE5z6gySrNjVRvmS8DcPuwV

- 支付给 Bob 的首次失败尝试

Alice 试图为支付给 Bob，但签名需要太长时间。指定的区块哈希已经过期，导致交易失败

$ solana pay -k alice.json --blockhash expiredDTaxfagttWjQweib42b6ZHADSx94Tw8gHx3W7 bob.json 1
[2020-01-02T18:48:28.462911000Z ERROR solana_cli::cli] Io(Custom { kind: Other, error: "Transaction \"33gQQaoPc9jWePMvDAeyJpcnSPiGUAdtVg8zREWv4GiKjkcGNufgpcbFyRKRrA25NkgjZySEeKue5rawyeH5TzsV\" failed: None" })
Error: Io(Custom { kind: Other, error: "Transaction \"33gQQaoPc9jWePMvDAeyJpcnSPiGUAdtVg8zREWv4GiKjkcGNufgpcbFyRKRrA25NkgjZySEeKue5rawyeH5TzsV\" failed: None" })

- 用 Nonce 来补救！

Alice 重试交易，这次指定她的nonce账户和存储在那里的区块哈希。

$ solana nonce-account nonce.json
balance: 1 SOL
minimum balance required: 0.00136416 SOL
nonce: F7vmkY3DTaxfagttWjQweib42b6ZHADSx94Tw8gHx3W7

$ solana pay -k alice.json --blockhash F7vmkY3DTaxfagtWjQweib42b6ZHADSx94Tw8gHx3W7 --nonce nonce.json bob.json 1
HR1368UKHVZyenmH7yVz5sBAijV6XAPeWbEiXEGVYQorRMcoijeNAbzZqEZiH8cDB8tk65ckeegFjK8dHwNFgQ

- 成功了！

交易成功！ Bob 从 Alice 那里收到1个SOL，并且Alice存储的nonce更新到了一个新的值

$ solana balance -k bob.json
1 SOL

$ solana nonce-account nonce.json
balance: 1 SOL
minimum balance required: 0.00136416 SOL
nonce: 6bjroqDcZgTv6Vavhqf81oBHTv3aMnX19UTB51YhAZnN

6.4 KiB Raw Blame History Unescape Escape