Skip to content

feat: add spl-token skill - #82

Open
PLP-N8n wants to merge 1 commit into
sendaifun:mainfrom
PLP-N8n:feat/add-spl-token-skill
Open

PLP-N8n wants to merge 1 commit into
sendaifun:mainfrom
PLP-N8n:feat/add-spl-token-skill

Conversation

@PLP-N8n

@PLP-N8n PLP-N8n commented Jun 29, 2026

Copy link
Copy Markdown

Summary

Adds a foundational spl-token skill for the classic SPL Token program — the counterpart to the existing token-2022 skill. It covers the operations every Solana agent needs for standard fungible tokens.

What the skill covers

  • Create & initialize mints (createMint, low-level createInitializeMintInstruction)
  • Associated Token Accounts — getOrCreateAssociatedTokenAccount, idempotent creation, getAssociatedTokenAddressSync
  • Mint / transfer / burn — with emphasis on the *Checked variants (decimals asserted on-chain)
  • Delegates (approve/revoke), authorities (setAuthority), freeze/thaw
  • Wrapped SOL (NATIVE_MINT, wrap via syncNative, unwrap via closeAccount)
  • Exact decimals/base-unit math (string-parsed bigint, no float precision loss)
  • Reading on-chain mint/account state

Structure

SKILL.md (spine) · resources/ (program addresses + full instruction reference) · templates/setup.ts · docs/troubleshooting.md · examples/ (two runnable, typechecked examples) — registered in marketplace.json.

Verification

  • TypeScript examples/templates pass tsc --noEmit (strict) against @solana/spl-token 0.4.14, @solana/web3.js 1.98.4, bs58 6.0.0.
  • Every SDK signature in the docs verified against the installed type definitions.
  • Reviewed for agent-followability with Claude Code. Not executed against a live cluster.

Checklist

  • Follows the template structure
  • Instructions are clear and unambiguous
  • Examples cover common use cases
  • Security best practices followed (no hardcoded keys; irreversible-authority warnings; unsigned-tx patterns)
  • Added entry to .claude-plugin/marketplace.json (alphabetical)

Signed-off-by: PLP-N8n 207336282+PLP-N8n@users.noreply.github.com

A foundational Solana agent skill for the classic SPL Token program, complementing the existing token-2022 skill.

- spl-token: create and manage classic SPL Token mints with @solana/spl-token — mints, associated token accounts (ATAs), minting, transfers (transferChecked), burning, delegates, authorities, freeze/thaw, wrapped SOL, and reading on-chain mint/account state. For standard tokens that do not need Token-2022 extensions.

Includes SKILL.md, two runnable examples, resources (program addresses + instruction reference), a setup template, and troubleshooting, and is registered in marketplace.json. Example/template TypeScript typechecks (tsc --noEmit, strict) against @solana/spl-token 0.4.14, @solana/web3.js 1.98.4, and bs58 6.0.0. Verified for agent-followability with Claude Code; not executed against a live cluster.

Signed-off-by: PLP-N8n <207336282+PLP-N8n@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant