feat(programs): add Associated Token Account program with wallet CLI and tutorial

Browse Source

Introduce the ATA program, which derives deterministic per-token holding
accounts from (owner, token_definition) via SHA256, eliminating the need
to manually create and track holding account IDs.

Program (programs/associated_token_account/):
- Create, Transfer, and Burn instructions with PDA-based authorization
- Deterministic address derivation: SHA256(owner || definition) → seed → AccountId
- Idempotent Create (no-op if ATA already exists)

Wallet CLI (`wallet ata`):
- `address` — derive ATA address locally (no network call)
- `create`  — initialize an ATA on-chain
- `send`    — transfer tokens from owner's ATA to a recipient
- `burn`    — burn tokens from owner's ATA
- `list`    — query ATAs across multiple token definitions

Usage:
  wallet deploy-program artifacts/program_methods/associated_token_account.bin
  wallet ata address --owner <ID> --token-definition <DEF_ID>
  wallet ata create --owner Public/<ID> --token-definition <DEF_ID>
  wallet ata send --from Public/<ID> --token-definition <DEF_ID> --to <RECIPIENT> --amount 100
  wallet ata burn --holder Public/<ID> --token-definition <DEF_ID> --amount 50
  wallet ata list --owner <ID> --token-definition <DEF1> <DEF2>

Includes tutorial: docs/LEZ testnet v0.1 tutorials/associated-token-accounts.md

...

This commit is contained in:

r4bbit

2026-03-26 13:19:29 +01:00

parent fb083ce91e

commit 0ed91e869e

31 changed files with 2049 additions and 3 deletions

Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL

Download Patch File Download Diff File Expand all files Collapse all files

artifacts/program_methods/amm.bin

BIN

Binary file not shown.

artifacts/program_methods/associated_token_account.bin

BIN

Binary file not shown.

artifacts/program_methods/authenticated_transfer.bin

BIN

Binary file not shown.

artifacts/program_methods/pinata.bin

BIN

Binary file not shown.

artifacts/program_methods/pinata_token.bin

BIN

Binary file not shown.

artifacts/program_methods/privacy_preserving_circuit.bin

BIN

Binary file not shown.

artifacts/program_methods/token.bin

BIN

Binary file not shown.