Program & State
The Hinkal Solana program is a single Anchor program. It exposes one set of instructions for users (deposits, transfers, swaps), and one for admins (initialize, ownership, access-token, token-limit, relayer whitelist). All persistent state lives in PDAs seeded by original_deployer.key(), allowing parallel deployments to coexist under the same program ID.
Seeds
seed_constants.rs:
STORAGE_ACCOUNT_SEED
b"hinkal"
StorageAccount
MERKLE_ACCOUNT_SEED
b"hinkal_merkle"
Commitment Merkle tree
MERKLE_ACCESS_TOKEN_ACCOUNT_SEED
b"hinkal_merkle_access_token"
Access-token Merkle tree
NULLIFIER_ACCOUNT_SEED
b"hinkal_nullifier"
Per-nullifier PDA
VAULT_ACCOUNT_SEED
b"hinkal_vault"
Storage vault (SystemAccount PDA)
ACCESS_TOKEN_ACCOUNT_SEED
b"hinkal_access_token"
AccessTokenStorageAccount
ACCESS_KEYS_ACCOUNT_SEED
b"hinkal_access_keys"
Per-access-key PDA
TOKEN_LIMIT_ACCOUNT_SEED
b"hinkal_token_limit"
Per-mint deposit/withdraw limit
SWAPPER_ACCOUNT_SEED
b"hinkal_swapper"
Per-swap CPI signer PDA
SWAP_STAGING_SEED
b"hinkal_swap_staging"
Staged swap proof + CPI batch
Account types
All account structs live in hinkal_accounts.rs and types.rs. Each carries a version: u8 enforced by the declare_versioned! macro (versions.rs), so old layouts revert with InvalidVersion after upgrades.
StorageAccount
version: u8whitelisted_relayers: Vec<Pubkey>(max 10)owner: Pubkeypending_owner: Pubkey(two-step ownership transfer; defaults to the system-program ID after acceptance)
Single per-deployment storage of relayer policy and ownership. Mutated only by admin instructions.
Merkle (zero-copy)
tree_levels: [[u8; 32]; 200]roots: [[u8; 32]; 100](MAX_ROOT_NUMBER = 100)m_index,root_index,levels,minimum_index- internal counters
Append-only commitment tree using Poseidon (poseidon::hash2). insert adds a leaf and writes a new root into a circular buffer of the last 100 roots; root_hash_exists walks the buffer in reverse from the latest pointer. The same struct is reused for the access-token tree under a different seed.
AccessTokenStorageAccount
access_token_owner_key: Pubkey
Identifies the only signer permitted to mint new access keys (add_access_token) or to authorize over-limit deposits.
AccesskeyAccount
is_added: bool
One PDA per access key, used as a uniqueness lock so a key cannot be inserted twice.
TokenLimitStorageAccount
amount_limit: u64
Per-(deployer, mint) threshold above which a flow requires an access token / access-token Merkle root membership.
NullifierAccount
is_used: bool
One PDA per nullifier. Created with init_if_needed by the transact, transfer or swap instruction that spends it, and flipped by process_nullifiers in the same instruction.
SwapStagingAccount
proof: ProofData(proof_a_arr,proof_b_arr,proof_c_arr,public_signals,encrypted_outputs)on_chain_encrypted_output: Vec<u8>instructions: Vec<SolanaInstructionData>
Written by prepare_swap at ["hinkal_swap_staging", deployer, signer, id], sized to its contents, and closed by swap with the rent returned to the signer.
Storage vault
A SystemAccount PDA at ["hinkal_vault", original_deployer]. It custodies all shielded SOL directly and is the authority for the SPL token ATAs that hold shielded token balances. It signs outgoing transfers via invoke_signed with the vault seeds (see transfer_utils.rs).
Init flow
initialize (instructions/initialize.rs) is called once per deployment by original_deployer:
Allocates
StorageAccount,AccessTokenStorageAccount, the commitmentMerkle, and the access-tokenMerkle.Pushes
original_deployerintowhitelisted_relayersand setsowner = original_deployer,pending_owner = default.Calls
Merkle::init(MAX_TREE_LEVELS)for both trees (zeroes all levels and roots, seedsm_index/minimum_index).Funds the storage vault PDA with rent-minimum lamports so it can hold balances.
Sets
access_token_owner_key = original_deployer.
After initialize, the per-mint flows still need:
init_token_limit(owner-only) for any mint the deployment will accept.
Last updated

