solace-zar-trustless-escrow 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: cdaf827139b0191b39f2e86adf1e2bb5a714ceca4809e0ce35fd912662e90878
+  data.tar.gz: 7b4c7dbf1a9544a78f2bdbce3c14965caa75c96d15bd2380aeffed6e8f4acc70
+SHA512:
+  metadata.gz: 0dcbcd5f20e0d349eed662845453561788d0c4a32a16edea05117d64d2621e6a51508bd7449370f15f7abf3e0d40e9b3e266a3bce3203e123f4dbac9a4514235
+  data.tar.gz: d3acc72bf804af39aadb54e0ff78f857f8c26ad87e51fdb924e5370eac60161f8c3105243e611b268df079bb94e7c978a3276eeab09ce0d0ca31719f083c10ec

data/lib/solace/zar_trustless_escrow/codecs_extensions.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+module Solace
+  module Utils
+    # Extensions to Solace::Utils::Codecs for the Borsh/Anchor types used by the
+    # ZAR Trustless Escrow program that the base solace gem does not provide.
+    #
+    # The base gem (>= 0.1.5) already provides encode_le_u64 / decode_le_u64 and
+    # the base58 helpers as module (self.) methods; this module reopens Codecs and
+    # uses `extend self` so the helpers below are callable both as instance methods
+    # (within composed encoders) and as Solace::Utils::Codecs.<method>.
+    module Codecs
+      extend self
+
+      # Encodes an i64 as 8 little-endian bytes (two's complement).
+      #
+      # @param i64 [Integer] Value in range -2**63..2**63-1.
+      # @return [String] 8-byte little-endian binary string.
+      def encode_le_i64(i64)
+        [i64].pack('q<')
+      end
+
+      # Encodes a public key as 32 bytes. Accepts any representation that resolves
+      # to a base58 string via #to_s (String, Keypair, PublicKey).
+      #
+      # @param pubkey [#to_s] The public key in any representation.
+      # @return [Array<Integer>] 32 bytes.
+      def encode_pubkey(pubkey)
+        Solace::Utils::Codecs.base58_to_bytes(pubkey.to_s)
+      end
+
+      # Encodes an Option<publicKey> in Borsh format.
+      # None → [0], Some(key) → [1] + 32 bytes.
+      #
+      # @param pubkey [#to_s, nil] Base58 public key or nil.
+      # @return [Array<Integer>]
+      def encode_option_pubkey(pubkey)
+        return [0] if pubkey.nil?
+
+        [1] + encode_pubkey(pubkey)
+      end
+
+      # Encodes an Option<i64> in Borsh format.
+      # None → [0], Some(i64) → [1] + 8 little-endian bytes.
+      #
+      # @param i64 [Integer, nil]
+      # @return [Array<Integer>]
+      def encode_option_i64(i64)
+        return [0] if i64.nil?
+
+        [1] + encode_le_i64(i64).bytes
+      end
+
+      # Decodes a u8 from 1 byte.
+      #
+      # @param stream [IO, StringIO] The stream to read from.
+      # @return [Integer] Value in range 0..255.
+      def decode_u8(stream)
+        stream.read(1).unpack1('C')
+      end
+
+      # Decodes an i64 from 8 little-endian bytes (two's complement).
+      #
+      # @param stream [IO, StringIO] The stream to read from.
+      # @return [Integer] Value in range -2**63..2**63-1.
+      def decode_le_i64(stream)
+        stream.read(8).unpack1('q<')
+      end
+
+      # Decodes a public key from 32 bytes.
+      #
+      # @param stream [IO, StringIO] The stream to read from.
+      # @return [String] Base58 public key.
+      def decode_pubkey(stream)
+        Solace::Utils::Codecs.bytes_to_base58(stream.read(32).bytes)
+      end
+
+      # Decodes an Option<publicKey> in Borsh format.
+      # None → nil, Some(key) → base58 pubkey.
+      #
+      # @param stream [IO, StringIO] The stream to read from.
+      # @return [String, nil] Base58 public key or nil.
+      def decode_option_pubkey(stream)
+        return nil if decode_u8(stream).zero?
+
+        decode_pubkey(stream)
+      end
+
+      # Decodes an Option<i64> in Borsh format.
+      # None → nil, Some(i64) → integer.
+      #
+      # @param stream [IO, StringIO] The stream to read from.
+      # @return [Integer, nil]
+      def decode_option_i64(stream)
+        return nil if decode_u8(stream).zero?
+
+        decode_le_i64(stream)
+      end
+    end
+  end
+end

data/lib/solace/zar_trustless_escrow/composers/claim_composer.rb

@@ -0,0 +1,136 @@
+# frozen_string_literal: true
+
+module Solace
+  module Composers
+    # Composes a `claim` instruction for the ZAR Trustless Escrow program.
+    #
+    # The claim authority releases an EscrowDeposit to the claimant and closes the
+    # deposit account (rent returns to the fee payer).
+    #
+    # Required params:
+    #   :mint                   [#to_s] Mint of the escrowed tokens.
+    #   :claim_authority        [#to_s, Keypair] Claim authority (readonly signer).
+    #   :claimant               [#to_s] Recipient of the released tokens.
+    #   :claimant_token_account [#to_s] Claimant's destination token account (ATA).
+    #   :escrow_deposit         [#to_s] EscrowDeposit PDA.
+    #   :program_token_account  [#to_s] Per-mint program vault PDA.
+    #   :fee_payer              [#to_s, Keypair] Fee payer (writable signer).
+    #
+    # Optional params:
+    #   :program_id       [#to_s] Escrow program id (default: PROGRAM_ID, mainnet).
+    #   :token_program_id [#to_s] Token program (default: legacy SPL Token).
+    class ZarTrustlessEscrowClaimComposer < Base
+      # Extracts the mint address from the params
+      #
+      # @return [String] The mint address
+      def mint
+        params[:mint].to_s
+      end
+
+      # Extracts the claim authority from the params
+      #
+      # @return [String] The claim authority address
+      def claim_authority
+        params[:claim_authority].to_s
+      end
+
+      # Extracts the claimant address from the params
+      #
+      # @return [String] The claimant address
+      def claimant
+        params[:claimant].to_s
+      end
+
+      # Extracts the claimant's destination token account from the params
+      #
+      # @return [String] The claimant token account address
+      def claimant_token_account
+        params[:claimant_token_account].to_s
+      end
+
+      # Extracts the EscrowDeposit PDA address from the params
+      #
+      # @return [String] The escrow deposit address
+      def escrow_deposit
+        params[:escrow_deposit].to_s
+      end
+
+      # Extracts the per-mint program vault address from the params
+      #
+      # @return [String] The program token account address
+      def program_token_account
+        params[:program_token_account].to_s
+      end
+
+      # Extracts the fee payer address from the params
+      #
+      # @return [String] The fee payer address
+      def fee_payer
+        params[:fee_payer].to_s
+      end
+
+      # Returns the escrow program id (defaults to the mainnet PROGRAM_ID)
+      #
+      # @return [String] The escrow program id
+      def program_id
+        (params[:program_id] || Solace::ZarTrustlessEscrow::PROGRAM_ID).to_s
+      end
+
+      # Returns the token program id (defaults to the legacy SPL Token program)
+      #
+      # @return [String] The token program id
+      def token_program_id
+        (params[:token_program_id] || Solace::Constants::TOKEN_PROGRAM_ID).to_s
+      end
+
+      # Returns the System Program id
+      #
+      # @return [String] The System Program id
+      def system_program
+        Solace::Constants::SYSTEM_PROGRAM_ID
+      end
+
+      # Returns the Associated Token Account Program id
+      #
+      # @return [String] The Associated Token Account Program id
+      def associated_token_program
+        Solace::Constants::ASSOCIATED_TOKEN_ACCOUNT_PROGRAM_ID
+      end
+
+      # Declares all accounts required by this instruction.
+      def setup_accounts
+        account_context.add_readonly_nonsigner(mint)
+        account_context.add_readonly_signer(claim_authority)
+        account_context.add_readonly_nonsigner(claimant)
+        account_context.add_writable_nonsigner(claimant_token_account)
+        account_context.add_writable_nonsigner(escrow_deposit)
+        account_context.add_writable_nonsigner(program_token_account)
+        account_context.add_writable_signer(fee_payer)
+        account_context.add_readonly_nonsigner(system_program)
+        account_context.add_readonly_nonsigner(token_program_id)
+        account_context.add_readonly_nonsigner(associated_token_program)
+        account_context.add_readonly_nonsigner(program_id)
+      end
+
+      # Builds the instruction with resolved account indices.
+      #
+      # @param context [Solace::Utils::AccountContext] Merged context from TransactionComposer.
+      # @return [Solace::Instruction]
+      def build_instruction(context)
+        Solace::ZarTrustlessEscrow::Instructions::ClaimInstruction.build(
+          mint_index:                     context.index_of(mint),
+          claim_authority_index:          context.index_of(claim_authority),
+          claimant_index:                 context.index_of(claimant),
+          claimant_token_account_index:   context.index_of(claimant_token_account),
+          escrow_deposit_index:           context.index_of(escrow_deposit),
+          program_token_account_index:    context.index_of(program_token_account),
+          fee_payer_index:                context.index_of(fee_payer),
+          system_program_index:           context.index_of(system_program),
+          token_program_index:            context.index_of(token_program_id),
+          associated_token_program_index: context.index_of(associated_token_program),
+          program_index:                  context.index_of(program_id)
+        )
+      end
+    end
+  end
+end

data/lib/solace/zar_trustless_escrow/composers/deposit_composer.rb

@@ -0,0 +1,145 @@
+# frozen_string_literal: true
+
+module Solace
+  module Composers
+    # Composes a `deposit` instruction for the ZAR Trustless Escrow program.
+    #
+    # Locks `amount` tokens from the depositor into a per-claim-authority
+    # EscrowDeposit PDA and the per-mint program vault. When a sponsor pays, the
+    # fee payer is the sponsor; otherwise the depositor pays.
+    #
+    # Required params:
+    #   :mint                    [#to_s] Mint of the escrowed tokens.
+    #   :depositor               [#to_s, Keypair] Depositor (writable signer).
+    #   :depositor_token_account [#to_s] Depositor's source token account.
+    #   :escrow_deposit          [#to_s] EscrowDeposit PDA.
+    #   :program_token_account   [#to_s] Per-mint program vault PDA.
+    #   :fee_payer               [#to_s, Keypair] Fee payer (writable signer).
+    #   :amount                  [Integer] u64 amount to deposit.
+    #   :claim_authority         [#to_s] Authority that can claim the deposit.
+    #
+    # Optional params:
+    #   :sponsor          [#to_s] Optional fee sponsor (default: nil).
+    #   :program_id       [#to_s] Escrow program id (default: PROGRAM_ID, mainnet).
+    #   :token_program_id [#to_s] Token program (default: legacy SPL Token).
+    class ZarTrustlessEscrowDepositComposer < Base
+      # Extracts the mint address from the params
+      #
+      # @return [String] The mint address
+      def mint
+        params[:mint].to_s
+      end
+
+      # Extracts the depositor address from the params
+      #
+      # @return [String] The depositor address
+      def depositor
+        params[:depositor].to_s
+      end
+
+      # Extracts the depositor's source token account address from the params
+      #
+      # @return [String] The depositor token account address
+      def depositor_token_account
+        params[:depositor_token_account].to_s
+      end
+
+      # Extracts the EscrowDeposit PDA address from the params
+      #
+      # @return [String] The escrow deposit address
+      def escrow_deposit
+        params[:escrow_deposit].to_s
+      end
+
+      # Extracts the per-mint program vault address from the params
+      #
+      # @return [String] The program token account address
+      def program_token_account
+        params[:program_token_account].to_s
+      end
+
+      # Extracts the fee payer address from the params
+      #
+      # @return [String] The fee payer address
+      def fee_payer
+        params[:fee_payer].to_s
+      end
+
+      # Extracts the deposit amount from the params
+      #
+      # @return [Integer] The u64 amount to deposit
+      def amount
+        params[:amount]
+      end
+
+      # Extracts the claim authority from the params
+      #
+      # @return [String] The claim authority address
+      def claim_authority
+        params[:claim_authority].to_s
+      end
+
+      # Extracts the optional fee sponsor from the params
+      #
+      # @return [String, nil] The sponsor address, or nil
+      def sponsor
+        params[:sponsor]&.to_s
+      end
+
+      # Returns the escrow program id (defaults to the mainnet PROGRAM_ID)
+      #
+      # @return [String] The escrow program id
+      def program_id
+        (params[:program_id] || Solace::ZarTrustlessEscrow::PROGRAM_ID).to_s
+      end
+
+      # Returns the token program id (defaults to the legacy SPL Token program)
+      #
+      # @return [String] The token program id
+      def token_program_id
+        (params[:token_program_id] || Solace::Constants::TOKEN_PROGRAM_ID).to_s
+      end
+
+      # Returns the System Program id
+      #
+      # @return [String] The System Program id
+      def system_program
+        Solace::Constants::SYSTEM_PROGRAM_ID
+      end
+
+      # Declares all accounts required by this instruction.
+      def setup_accounts
+        account_context.add_readonly_nonsigner(mint)
+        account_context.add_writable_signer(depositor)
+        account_context.add_writable_nonsigner(depositor_token_account)
+        account_context.add_writable_nonsigner(escrow_deposit)
+        account_context.add_writable_nonsigner(program_token_account)
+        account_context.add_writable_signer(fee_payer)
+        account_context.add_readonly_nonsigner(system_program)
+        account_context.add_readonly_nonsigner(token_program_id)
+        account_context.add_readonly_nonsigner(program_id)
+      end
+
+      # Builds the instruction with resolved account indices.
+      #
+      # @param context [Solace::Utils::AccountContext] Merged context from TransactionComposer.
+      # @return [Solace::Instruction]
+      def build_instruction(context)
+        Solace::ZarTrustlessEscrow::Instructions::DepositInstruction.build(
+          amount:,
+          claim_authority:,
+          sponsor:,
+          mint_index:                    context.index_of(mint),
+          depositor_index:               context.index_of(depositor),
+          depositor_token_account_index: context.index_of(depositor_token_account),
+          escrow_deposit_index:          context.index_of(escrow_deposit),
+          program_token_account_index:   context.index_of(program_token_account),
+          fee_payer_index:               context.index_of(fee_payer),
+          system_program_index:          context.index_of(system_program),
+          token_program_index:           context.index_of(token_program_id),
+          program_index:                 context.index_of(program_id)
+        )
+      end
+    end
+  end
+end

data/lib/solace/zar_trustless_escrow/composers/mediated_deposit_composer.rb

@@ -0,0 +1,173 @@
+# frozen_string_literal: true
+
+module Solace
+  module Composers
+    # Composes a `mediated_deposit` instruction for the ZAR Trustless Escrow
+    # program.
+    #
+    # Locks `amount` tokens into a three-party MediatedEscrowDeposit PDA (keyed by
+    # `id`) and the per-mint program vault. The mediator decides the outcome; an
+    # optional expiry lets the depositor reclaim after the timestamp passes.
+    #
+    # Required params:
+    #   :mint                    [#to_s] Mint of the escrowed tokens.
+    #   :depositor               [#to_s, Keypair] Depositor (writable signer).
+    #   :depositor_token_account [#to_s] Depositor's source token account.
+    #   :mediated_escrow_deposit [#to_s] MediatedEscrowDeposit PDA.
+    #   :program_token_account   [#to_s] Per-mint program vault PDA.
+    #   :fee_payer               [#to_s, Keypair] Fee payer (writable signer).
+    #   :amount                  [Integer] u64 amount to deposit.
+    #   :id                      [#to_s] Unique id used to derive the escrow PDA.
+    #   :mediator                [#to_s] Mediator who decides the outcome.
+    #   :beneficiary             [#to_s] Beneficiary the mediator may release to.
+    #
+    # Optional params:
+    #   :rent_collector   [#to_s] Optional rent collector on close (default: nil).
+    #   :expires_at       [Integer] Optional unix timestamp for reclaim (default: nil).
+    #   :program_id       [#to_s] Escrow program id (default: PROGRAM_ID, mainnet).
+    #   :token_program_id [#to_s] Token program (default: legacy SPL Token).
+    class ZarTrustlessEscrowMediatedDepositComposer < Base
+      # Extracts the mint address from the params
+      #
+      # @return [String] The mint address
+      def mint
+        params[:mint].to_s
+      end
+
+      # Extracts the depositor address from the params
+      #
+      # @return [String] The depositor address
+      def depositor
+        params[:depositor].to_s
+      end
+
+      # Extracts the depositor's source token account from the params
+      #
+      # @return [String] The depositor token account address
+      def depositor_token_account
+        params[:depositor_token_account].to_s
+      end
+
+      # Extracts the MediatedEscrowDeposit PDA address from the params
+      #
+      # @return [String] The mediated escrow deposit address
+      def mediated_escrow_deposit
+        params[:mediated_escrow_deposit].to_s
+      end
+
+      # Extracts the per-mint program vault address from the params
+      #
+      # @return [String] The program token account address
+      def program_token_account
+        params[:program_token_account].to_s
+      end
+
+      # Extracts the fee payer address from the params
+      #
+      # @return [String] The fee payer address
+      def fee_payer
+        params[:fee_payer].to_s
+      end
+
+      # Extracts the deposit amount from the params
+      #
+      # @return [Integer] The u64 amount to deposit
+      def amount
+        params[:amount]
+      end
+
+      # Extracts the unique escrow id from the params
+      #
+      # @return [String] The escrow id
+      def id
+        params[:id].to_s
+      end
+
+      # Extracts the mediator from the params
+      #
+      # @return [String] The mediator address
+      def mediator
+        params[:mediator].to_s
+      end
+
+      # Extracts the beneficiary from the params
+      #
+      # @return [String] The beneficiary address
+      def beneficiary
+        params[:beneficiary].to_s
+      end
+
+      # Extracts the optional rent collector from the params
+      #
+      # @return [String, nil] The rent collector address, or nil
+      def rent_collector
+        params[:rent_collector]&.to_s
+      end
+
+      # Extracts the optional expiry timestamp from the params
+      #
+      # @return [Integer, nil] The unix expiry timestamp, or nil
+      def expires_at
+        params[:expires_at]
+      end
+
+      # Returns the escrow program id (defaults to the mainnet PROGRAM_ID)
+      #
+      # @return [String] The escrow program id
+      def program_id
+        (params[:program_id] || Solace::ZarTrustlessEscrow::PROGRAM_ID).to_s
+      end
+
+      # Returns the token program id (defaults to the legacy SPL Token program)
+      #
+      # @return [String] The token program id
+      def token_program_id
+        (params[:token_program_id] || Solace::Constants::TOKEN_PROGRAM_ID).to_s
+      end
+
+      # Returns the System Program id
+      #
+      # @return [String] The System Program id
+      def system_program
+        Solace::Constants::SYSTEM_PROGRAM_ID
+      end
+
+      # Declares all accounts required by this instruction.
+      def setup_accounts
+        account_context.add_readonly_nonsigner(mint)
+        account_context.add_writable_signer(depositor)
+        account_context.add_writable_nonsigner(depositor_token_account)
+        account_context.add_writable_nonsigner(mediated_escrow_deposit)
+        account_context.add_writable_nonsigner(program_token_account)
+        account_context.add_writable_signer(fee_payer)
+        account_context.add_readonly_nonsigner(system_program)
+        account_context.add_readonly_nonsigner(token_program_id)
+        account_context.add_readonly_nonsigner(program_id)
+      end
+
+      # Builds the instruction with resolved account indices.
+      #
+      # @param context [Solace::Utils::AccountContext] Merged context from TransactionComposer.
+      # @return [Solace::Instruction]
+      def build_instruction(context)
+        Solace::ZarTrustlessEscrow::Instructions::MediatedDepositInstruction.build(
+          amount:,
+          id:,
+          mediator:,
+          beneficiary:,
+          rent_collector:,
+          expires_at:,
+          mint_index:                    context.index_of(mint),
+          depositor_index:               context.index_of(depositor),
+          depositor_token_account_index: context.index_of(depositor_token_account),
+          mediated_escrow_deposit_index: context.index_of(mediated_escrow_deposit),
+          program_token_account_index:   context.index_of(program_token_account),
+          fee_payer_index:               context.index_of(fee_payer),
+          system_program_index:          context.index_of(system_program),
+          token_program_index:           context.index_of(token_program_id),
+          program_index:                 context.index_of(program_id)
+        )
+      end
+    end
+  end
+end

data/lib/solace/zar_trustless_escrow/composers/mediated_reclaim_composer.rb

@@ -0,0 +1,137 @@
+# frozen_string_literal: true
+
+module Solace
+  module Composers
+    # Composes a `mediated_reclaim` instruction for the ZAR Trustless Escrow
+    # program.
+    #
+    # After the escrow's expiry passes, the original depositor reclaims a
+    # MediatedEscrowDeposit and closes the deposit account (rent returns to the
+    # depositor). Requires the escrow to have been created with an expiry.
+    #
+    # Required params:
+    #   :mint                    [#to_s] Mint of the escrowed tokens.
+    #   :depositor               [#to_s, Keypair] Depositor (writable signer, receives rent).
+    #   :depositor_token_account [#to_s] Depositor's destination token account (ATA).
+    #   :mediated_escrow_deposit [#to_s] MediatedEscrowDeposit PDA.
+    #   :program_token_account   [#to_s] Per-mint program vault PDA.
+    #   :fee_payer               [#to_s, Keypair] Fee payer (writable signer).
+    #   :id                      [#to_s] Unique id used to derive the escrow PDA.
+    #
+    # Optional params:
+    #   :program_id       [#to_s] Escrow program id (default: PROGRAM_ID, mainnet).
+    #   :token_program_id [#to_s] Token program (default: legacy SPL Token).
+    class ZarTrustlessEscrowMediatedReclaimComposer < Base
+      # Extracts the mint address from the params
+      #
+      # @return [String] The mint address
+      def mint
+        params[:mint].to_s
+      end
+
+      # Extracts the depositor address from the params
+      #
+      # @return [String] The depositor address
+      def depositor
+        params[:depositor].to_s
+      end
+
+      # Extracts the depositor's destination token account from the params
+      #
+      # @return [String] The depositor token account address
+      def depositor_token_account
+        params[:depositor_token_account].to_s
+      end
+
+      # Extracts the MediatedEscrowDeposit PDA address from the params
+      #
+      # @return [String] The mediated escrow deposit address
+      def mediated_escrow_deposit
+        params[:mediated_escrow_deposit].to_s
+      end
+
+      # Extracts the per-mint program vault address from the params
+      #
+      # @return [String] The program token account address
+      def program_token_account
+        params[:program_token_account].to_s
+      end
+
+      # Extracts the fee payer address from the params
+      #
+      # @return [String] The fee payer address
+      def fee_payer
+        params[:fee_payer].to_s
+      end
+
+      # Extracts the unique escrow id from the params
+      #
+      # @return [String] The escrow id
+      def id
+        params[:id].to_s
+      end
+
+      # Returns the escrow program id (defaults to the mainnet PROGRAM_ID)
+      #
+      # @return [String] The escrow program id
+      def program_id
+        (params[:program_id] || Solace::ZarTrustlessEscrow::PROGRAM_ID).to_s
+      end
+
+      # Returns the token program id (defaults to the legacy SPL Token program)
+      #
+      # @return [String] The token program id
+      def token_program_id
+        (params[:token_program_id] || Solace::Constants::TOKEN_PROGRAM_ID).to_s
+      end
+
+      # Returns the System Program id
+      #
+      # @return [String] The System Program id
+      def system_program
+        Solace::Constants::SYSTEM_PROGRAM_ID
+      end
+
+      # Returns the Associated Token Account Program id
+      #
+      # @return [String] The Associated Token Account Program id
+      def associated_token_program
+        Solace::Constants::ASSOCIATED_TOKEN_ACCOUNT_PROGRAM_ID
+      end
+
+      # Declares all accounts required by this instruction.
+      def setup_accounts
+        account_context.add_readonly_nonsigner(mint)
+        account_context.add_writable_signer(depositor)
+        account_context.add_writable_nonsigner(depositor_token_account)
+        account_context.add_writable_nonsigner(mediated_escrow_deposit)
+        account_context.add_writable_nonsigner(program_token_account)
+        account_context.add_writable_signer(fee_payer)
+        account_context.add_readonly_nonsigner(system_program)
+        account_context.add_readonly_nonsigner(token_program_id)
+        account_context.add_readonly_nonsigner(associated_token_program)
+        account_context.add_readonly_nonsigner(program_id)
+      end
+
+      # Builds the instruction with resolved account indices.
+      #
+      # @param context [Solace::Utils::AccountContext] Merged context from TransactionComposer.
+      # @return [Solace::Instruction]
+      def build_instruction(context)
+        Solace::ZarTrustlessEscrow::Instructions::MediatedReclaimInstruction.build(
+          id:,
+          mint_index:                     context.index_of(mint),
+          depositor_index:                context.index_of(depositor),
+          depositor_token_account_index:  context.index_of(depositor_token_account),
+          mediated_escrow_deposit_index:  context.index_of(mediated_escrow_deposit),
+          program_token_account_index:    context.index_of(program_token_account),
+          fee_payer_index:                context.index_of(fee_payer),
+          system_program_index:           context.index_of(system_program),
+          token_program_index:            context.index_of(token_program_id),
+          associated_token_program_index: context.index_of(associated_token_program),
+          program_index:                  context.index_of(program_id)
+        )
+      end
+    end
+  end
+end