Class: Solace::Instructions::Token2022::TransferInstruction

Inherits:
Object
  • Object
show all
Defined in:
lib/solace/instructions/token_2022/transfer_instruction.rb

Overview

Instruction for transferring tokens via the Token-2022 program.

Examples:

Build a Transfer instruction

instruction = Solace::Instructions::Token2022::TransferInstruction.build(
  amount: 100,
  owner_index: 1,
  source_index: 2,
  destination_index: 3,
  program_index: 4
)

Since:

  • 0.1.5

Constant Summary collapse

INSTRUCTION_INDEX =

Since:

  • 0.1.5

[3].freeze

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Attribute Details

#INSTRUCTION_INDEX ⇒ Object (readonly)

Instruction index for Token-2022’s Transfer instruction.



33
 
# File 'lib/solace/instructions/token_2022/transfer_instruction.rb', line 33

INSTRUCTION_INDEX = [3].freeze

Class Method Details

.build(amount:, owner_index:, source_index:, destination_index:, program_index:) ⇒ Solace::Instruction

Builds a Transfer instruction.

Parameters:

  • amount (Integer) —

    The amount of tokens to transfer.

  • source_index (Integer) —

    The index of the source token account.

  • destination_index (Integer) —

    The index of the destination token account.

  • owner_index (Integer) —

    The index of the source account’s owner.

  • program_index (Integer) —

    The index of the Token-2022 Program.

Returns:

Since:

  • 0.1.5



43
44
45
46
47
48
49
50
51
52
53
54
55
 
# File 'lib/solace/instructions/token_2022/transfer_instruction.rb', line 43

def self.build(
  amount:,
  owner_index:,
  source_index:,
  destination_index:,
  program_index:
)
  Solace::Instruction.new.tap do |ix|
    ix.program_index = program_index
    ix.accounts = [source_index, destination_index, owner_index]
    ix.data = data(amount)
  end
end

.data(amount) ⇒ Array<Integer>

Builds the data for a Transfer instruction.

The BufferLayout is:

- [Instruction Index (1 byte)]
- [Amount (8 bytes)]

Parameters:

  • amount (Integer) —

    The amount of tokens to transfer.

Returns:

  • (Array<Integer>) —

    1-byte instruction index + 8-byte amount

Since:

  • 0.1.5



65
66
67
 
# File 'lib/solace/instructions/token_2022/transfer_instruction.rb', line 65

def self.data(amount)
  INSTRUCTION_INDEX + Solace::Utils::Codecs.encode_le_u64(amount).bytes
end