solana指令解析-associated token account(ATA)

什么是associated token account(ATA)?

associated token account 称为关联代币账户，通过ATAP创建，用来保存有关特定代币、其余额及其所有者的信息。它是与特定代币账户（可以理解为以太坊的erc20合约）关联的账户。 ATA 允许用户对该代币进行交易和管理。

• solana中将erc20代币称为SPL代币（solana中一个代币，仅仅是一个归Token合约管理的普通的Account对象，即代币账户。关于具体相关说明，可参考：https://www.solanazh.com/course/1-3
• 参考学习：(推荐) https://www.alchemy.com/overviews/associated-token-account
• AssociatedTokenAccountProgramID: ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL

  什么是Associated Token Account Program（ATAP）？

  • Associated Token Account Program称关联代币程序（ATAP）是每个 ATA 的父程序。提供了将用户的钱包地址映射到他们持有的关联代币帐户的机制（ATA）。允许发送者为接收者创建关联的token帐户，以便token传输正常进行。
  • ATAP能够确保如果一个用户想要向另一个用户发送token，接收者能够获得该token，即使他没有相应令牌的 ATA

    token转账：

    参考：【Token 轉帳交易部分】https://www.blocktempo.com/understand-solana-accounts-tokens-transactions-and-asset-security/

    • 前提：默认账户A拥有’USDT’代币
      • 拥有指定代币的用户拥有通过ATAP 创建的关联代币账户(ATA) (简单来说，拥有usdt代币的账户将会拥有一个由ATAP创建的一个与USDT代币关联的ATA账户，用来存储这个账户拥有的USDT代币的余额)
      • 账户之间的token转账交易直接发生在账户的 ATA 之间，需要注意的是：在 token 转账指令中，source 和 destination 地址通常指的是 ATA 地址，而不是转账双方的直接账户地址

        associated token account指令汇总

        指令	值	说明
        CreateAssociatedTokenAccount	0	创建一个关联代币账户(account已存在会报错)
        CreateIdempotent	1	创建一个幂等的（具有幂等性质的）关联代币账户，即多次执行同一操作，结果都是一样的。（account已存在不会报错）
        RecoverNested	2	用于从嵌套的关联代币账户中转移资金并关闭它。

        源码地址：github.com/blocto/solana-go-sdk/program/associated_token_account

        1.CreateAssociatedTokenAccount

        该指令用于创建一个关联代币账户。在 Solana 区块链上，当用户需要与特定代币进行交互时，需要先创建一个关联代币账户，以便存储该代币的余额信息。该指令允许用户创建一个新的关联代币账户。

        • 如果AssociatedTokenAccount已经存在，将会返回错误

          1.1源码

          type CreateParam struct {
          	Funder                 common.PublicKey
          	Owner                  common.PublicKey
          	Mint                   common.PublicKey
          	AssociatedTokenAccount common.PublicKey
          }
          // Create creates an associated token account for the given wallet address and token mint. Return an error if the account exists.
          func Create(param CreateParam) types.Instruction {
          	data, err := borsh.Serialize(struct {
          		Instruction Instruction
          	}{
          		Instruction: InstructionCreate,
          	})
          	if err != nil {
          		panic(err)
          	}
          	return types.Instruction{
          		ProgramID: common.SPLAssociatedTokenAccountProgramID,
          		Accounts: []types.AccountMeta{
          			{PubKey: param.Funder, IsSigner: true, IsWritable: true},
          			{PubKey: param.AssociatedTokenAccount, IsSigner: false, IsWritable: true},
          			{PubKey: param.Owner, IsSigner: false, IsWritable: false},
          			{PubKey: param.Mint, IsSigner: false, IsWritable: false},
          			{PubKey: common.SystemProgramID, IsSigner: false, IsWritable: false},
          			{PubKey: common.TokenProgramID, IsSigner: false, IsWritable: false},
          			{PubKey: common.SysVarRentPubkey, IsSigner: false, IsWritable: false},
          		},
          		Data: data,
          	}
          }
          

          1.2 指令参数：

          • Funder：用于支付交易费用的账户的公钥。
          • Owner：新关联代币账户的所有者的公钥。所有者是新关联代币账户的实际控制者，具有对该账户进行操作的权限。
          • Mint：与新关联代币账户关联的代币的公钥。代币的发行者可以通过该公钥查看关联的代币账户。
          • AssociatedTokenAccount：要创建的关联代币账户的公钥。

            1.3AccountMate

            • PubKey: 账户的公钥
            • IsSigner ：表示该账户是否需要签名验证。
            • IsWritable： 表示该账户是否可以被写入数据

              PubKey	IsSigner	IsWritable
              Funder	true	true
              AssociatedTokenAccount	false	true
              Owner	false	false
              Mint	false	false
              SystemProgramID	false	false
              TokenProgramID	false	false
              SysVarRentPubkey	false	false

              • SystemProgramID表示系统程序的公钥，用于执行 address_lookup_table 指令的程序。值为11111111111111111111111111111111
              • TokenProgramID表示代币程序，是 Solana 区块链上管理代币的标准程序。在创建关联代币账户时，需要指定代币程序以确保账户与代币的管理逻辑一致。值为TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
              • SysVarRentPubkey是系统变量之一，用于存储账户租金信息。在创建关联代币账户时，需要考虑账户的租金，因此需要引用系统变量来获取相应的信息。值为SysvarRent111111111111111111111111111111111

                2.CreateIdempotent

                这个指令与 InstructionCreate 类似，但具有幂等性质。这意味着如果多次执行相同的创建关联代币账户的操作，结果都是相同的。这样的设计可以确保在网络中进行重试或发生错误时，不会导致创建多个相同的账户。

                2.1源码

                type CreateIdempotentParam struct {
                	Funder                 common.PublicKey
                	Owner                  common.PublicKey
                	Mint                   common.PublicKey
                	AssociatedTokenAccount common.PublicKey
                }
                // CreateIdempotent creates an associated token account for the given wallet address and token mint,
                // if it doesn't already exist. Returns an error if the account exists, but with a different owner.
                func CreateIdempotent(param CreateIdempotentParam) types.Instruction {
                	data, err := borsh.Serialize(struct {
                		Instruction Instruction
                	}{
                		Instruction: InstructionCreateIdempotent,
                	})
                	if err != nil {
                		panic(err)
                	}
                	return types.Instruction{
                		ProgramID: common.SPLAssociatedTokenAccountProgramID,
                		Accounts: []types.AccountMeta{
                			{PubKey: param.Funder, IsSigner: true, IsWritable: true},
                			{PubKey: param.AssociatedTokenAccount, IsSigner: false, IsWritable: true},
                			{PubKey: param.Owner, IsSigner: false, IsWritable: false},
                			{PubKey: param.Mint, IsSigner: false, IsWritable: false},
                			{PubKey: common.SystemProgramID, IsSigner: false, IsWritable: false},
                			{PubKey: common.TokenProgramID, IsSigner: false, IsWritable: false},
                			{PubKey: common.SysVarRentPubkey, IsSigner: false, IsWritable: false},
                		},
                		Data: data,
                	}
                }
                

                • 参数与accountmeta与CreateAssociatedTokenAccount 指令一致,参考上文即可

                • 如果AssociatedTokenAccount 不存在，则创建一个新的关联代币账户，如果账户已经存在，但所有者不同，则返回错误。

                  3.RecoverNested

                  个指令用于从嵌套的关联代币账户中转移资金并关闭它。有时候，用户可能会创建一个关联代币账户，并将其作为另一个关联代币账户的所有者。当需要关闭这个嵌套的关联代币账户时，可以使用该指令将其中的资金转移到其他地方，并关闭该账户。

                  3.1源码

                  type RecoverNestedParam struct {
                  	Owner                             common.PublicKey
                  	OwnerMint                         common.PublicKey
                  	OwnerAssociatedTokenAccount       common.PublicKey
                  	NestedMint                        common.PublicKey
                  	NestedMintAssociatedTokenAccount  common.PublicKey
                  	DestinationAssociatedTokenAccount common.PublicKey
                  }
                  // RecoverNested transfers from and closes a nested associated token account: an associated token account owned by an associated token account.
                  func RecoverNested(param RecoverNestedParam) types.Instruction {
                  	data, err := borsh.Serialize(struct {
                  		Instruction Instruction
                  	}{
                  		Instruction: InstructionRecoverNested,
                  	})
                  	if err != nil {
                  		panic(err)
                  	}
                  	return types.Instruction{
                  		ProgramID: common.SPLAssociatedTokenAccountProgramID,
                  		Accounts: []types.AccountMeta{
                  			{PubKey: param.NestedMintAssociatedTokenAccount, IsSigner: false, IsWritable: true},
                  			{PubKey: param.NestedMint, IsSigner: false, IsWritable: false},
                  			{PubKey: param.DestinationAssociatedTokenAccount, IsSigner: false, IsWritable: true},
                  			{PubKey: param.OwnerAssociatedTokenAccount, IsSigner: false, IsWritable: true},
                  			{PubKey: param.OwnerMint, IsSigner: false, IsWritable: false},
                  			{PubKey: param.Owner, IsSigner: true, IsWritable: true},
                  			{PubKey: common.TokenProgramID, IsSigner: false, IsWritable: false},
                  		},
                  		Data: data,
                  	}
                  }
                  

                  3.2指令参数

                  • Owner：表示要执行恢复操作的账户的公钥。
                  • OwnerMint：表示所属代币的公钥。
                  • OwnerAssociatedTokenAccount：表示所属关联代币账户的公钥。
                  • NestedMint：表示嵌套代币的公钥。
                  • NestedMintAssociatedTokenAccount：表示嵌套关联代币账户的公钥。
                  • DestinationAssociatedTokenAccount：表示目标关联代币账户的公钥。

                    3.3AccountMeta

                    PubKey	IsSigner	IsWritable
                    NestedMintAssociatedTokenAccount	false	true
                    NestedMint	false	false
                    DestinationAssociatedTokenAccount	false	true
                    OwnerAssociatedTokenAccount	false	true
                    OwnerMint	false	false
                    Owner	true	true
                    TokenProgramID	false	false