light-token-client

Light Token クライアント SDK

@lightprotocol/compressed-token（TypeScript）および light_token_client（Rust）を使用するクライアント側のクックブックです。トークンに関するすべての操作を解説します。ミント、関連付けられたトークンアカウントの作成、転送、承認、承認の取り消し、バーン、ラップ、ラップ解除、凍結、凍結解除、クローズ、読み込みに対応しています。

作成コスト	SPL	Light Token
トークンアカウント	~2,000,000 lamports	~11,000 lamports

前提条件

例では、localnet と devnet の両方の設定を示します。devnet の場合は、次のように設定します。

• API_KEY 環境変数 — Helius または Triton RPC API キー。本番環境では、シークレットマネージャーから読み込みます。
• ~/.config/solana/id.json — ローカルの Solana キーペア（solana-keygen new）。本番環境では、シークレットマネージャーから読み込みます。

ワークフロー

1. 意図を明確にする
   • プランモードが有効でない場合は、有効にすることを推奨します
   • AskUserQuestion を使って不明点を解消します
   • 実行を始める前に、すべての質問を解決する必要があります
2. 参照資料とスキルを特定する
   • タスクを以下のドメイン別リファレンスに照らし合わせます
   • 関連するドキュメントと例を探します
3. 計画ファイルを作成する（YAML タスク形式）
   • 不明な点があれば AskUserQuestion を使います。推測や思い込みは避けてください
   • 権限、依存関係、不明点などのブロッカーを特定します
   • 実行を始める前に計画を完成させる必要があります
4. 実行する
   • 並行して調査するには、サブエージェントと Task ツールを使います
   • サブエージェントは Skill ツールを使ってスキルを読み込みます
   • TodoWrite で進捗を追跡します
5. 行き詰まった場合：Read、Glob、Grep、DeepWiki MCP アクセスが可能な読み取り専用のサブエージェントを起動するよう依頼し、skills/ask-mcp を読み込ませます。読み取り範囲は、スキルのリファレンス、サンプルリポジトリ、ドキュメントに限定します。

ドメインリファレンス

タスク	リファレンス
ミントを作成する	create-mint.md
SPL インターフェース PDA を作成する	create-interface-pda.md
関連トークンアカウントを作成する	create-associated-token-account.md
トークンアカウントを作成する	create-token-account.md
トークンをミントする	mint-to.md
トークンを転送する	transfer-interface.md
チェック付きで転送する	transfer-checked.md
デリゲートを承認する	approve.md
デリゲートを取り消す	revoke.md
デリゲート転送	delegate-transfer.md
SPL を Light にラップする	wrap.md
Light を SPL にアンラップする	unwrap.md
関連トークンアカウントを読み込む	load-associated-token-account.md
トークンをバーンする	burn.md
チェック付きでバーンする	burn-checked.md
トークンアカウントを凍結する	freeze.md
トークンアカウントを凍結解除する	thaw.md
トークンアカウントを閉じる	close-token-account.md
SPL をミント、ラップ、転送する	spl-mint-wrap-transfer.md
SPL と Light の比較	spl-to-light.md
Token 2022 拡張機能の概要	extensions/overview.md
メタデータと MetadataPointer	extensions/metadata-and-metadata-pointer.md
転送手数料	extensions/transfer-fees.md
転送フック	extensions/transfer-hook.md
利息付きトークン	extensions/interest-bearing-tokens.md
デフォルトのアカウント状態	extensions/default-account-state.md
永続デリゲート	extensions/permanent-delegate.md
ミントのクローズ権限	extensions/close-mint.md
トークングループとメンバー	extensions/token-groups-and-members.md
一時停止可能なミント	extensions/pausable-mint.md
機密転送	extensions/confidential-transfer.md

操作の概要

操作	TypeScript	Rust	ドキュメント
Light ミントを作成	createMintInterface	CreateMint	ミントの作成
インターフェース PDA 付きの SPL ミントを作成	createMintInterface + TOKEN_PROGRAM_ID	—	ミントの作成
インターフェース PDA 付きの T22 ミントを作成	createMintInterface + TOKEN_2022_PROGRAM_ID	—	ミントの作成
既存のミントにインターフェース PDA を追加	createSplInterface	—	ミントの作成
関連トークンアカウントを作成	createAtaInterface	CreateAta	ATA の作成
トークンアカウントを作成	—	CreateTokenAccount	トークンアカウントの作成
ミント	mintToInterface	MintTo	ミント
転送	transferInterface	TransferInterface	インターフェース経由の転送
チェック付き転送	—	TransferChecked	チェック付き転送
承認	approveInterface	Approve	承認・取り消し
取り消し	revokeInterface	Revoke	承認・取り消し
委任転送	transferInterface + { owner }	—	承認・取り消し
バーン	—	Burn	バーン
チェック付きバーン	—	BurnChecked	バーン
SPL を Light にラップ	wrap	Wrap	ラップ・アンラップ
Light を SPL にアンラップ	unwrap	Unwrap	ラップ・アンラップ
関連トークンアカウントを読み込み（コールドからホットへ）	loadAta	—	ATA の読み込み
凍結	—	Freeze	凍結・凍結解除
凍結解除	—	Thaw	凍結・凍結解除
閉じる	—	Close	トークンアカウントを閉じる

外部リファレンス

リソース	リンク
ドキュメントのクックブック	zkcompression.com/light-token/cookbook
TypeScript の例	examples-light-token/typescript-client
Rust の例	examples-light-token/rust-client
@lightprotocol/stateless.js	API ドキュメント
@lightprotocol/compressed-token	API ドキュメント
light-client	docs.rs
light-token-client	docs.rs
light-token	docs.rs

セキュリティ

このスキルは外部シークレットを取得、保存、送信しません。コードパターン、ドキュメントへの参照、開発ガイダンスのみを提供します。

• 宣言された依存関係。 Devnet と mainnet の例では、API_KEY（Helius または Triton の RPC キー）が必要で、ペイヤーのキーペアとして ~/.config/solana/id.json を読み込みます。localnet ではどちらも不要です。本番環境では、両方をシークレットマネージャーから読み込んでください。
• ユーザーが指定する構成。 RPC エンドポイント、ウォレットのキーペア、認証トークンは、ユーザーのアプリケーションコードで設定します。このスキルはパターンを示すものであり、シークレットを保存または送信することはありません。
• インストール元。 npx skills add Lightprotocol/skills は、公開 GitHub リポジトリ（Lightprotocol/skills）からインストールします。実行する前に、インストール元を確認してください。
• サブエージェントの範囲。 行き詰まった場合、このスキルは、スキルのリファレンス、サンプルリポジトリ、ドキュメントに対象を限定し、Read、Glob、Grep を使用する読み取り専用のサブエージェントを起動するよう求めます。
• 監査済みプロトコル。 Light Protocol のスマートコントラクトは、独立した監査を受けています。監査レポートは github.com/Lightprotocol/light-protocol/tree/main/audits で公開されています。