light-token-client

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Light Token Client SDKs

Light Token客户端SDK

Client-side cookbook for

@lightprotocol/compressed-token

(TypeScript) and

light_token_client

(Rust). Covers all token operations: create mints, associated token accounts, transfer, approve, revoke, burn, wrap, unwrap, freeze, thaw, close, and load.

这是

@lightprotocol/compressed-token

（TypeScript版）和

light_token_client

（Rust版）的客户端使用手册，涵盖所有代币操作：创建铸币、关联代币账户、转账、授权、撤销授权、销毁、封装、解封装、冻结、解冻、关闭账户以及加载账户。

Workflow

工作流程

Clarify intent
- Recommend plan mode, if it's not activated
- Use
```
AskUserQuestion
```
  to resolve blind spots
- All questions must be resolved before execution
Identify references and skills
- Match task to domain references below
- Locate relevant documentation and examples
Write plan file (YAML task format)
- Use
```
AskUserQuestion
```
  for anything unclear — never guess or assume
- Identify blockers: permissions, dependencies, unknowns
- Plan must be complete before execution begins
Execute
- Use
```
Task
```
  tool with subagents for parallel research
- Subagents load skills via
```
Skill
```
  tool
- Track progress with
```
TodoWrite
```
When stuck: spawn subagent with
```
Read
```
,
```
Glob
```
,
```
Grep
```
, DeepWiki MCP access and load
```
skills/ask-mcp
```

明确需求
- 若未激活计划模式，建议启用该模式
- 使用
```
AskUserQuestion
```
  来解决疑问点
- 所有问题必须在执行前解决
确定参考资料与技能
- 将任务与下方的【领域参考资料】匹配
- 查找相关文档和示例
编写计划文件（YAML任务格式）
- 任何不明确的地方都使用
```
AskUserQuestion
```
  ，切勿猜测或假设
- 识别阻碍因素：权限、依赖项、未知内容
- 计划必须完整才能开始执行
执行任务
- 使用
```
Task
```
  工具并结合子代理进行并行研究
- 子代理通过
```
Skill
```
  工具加载技能
- 使用
```
TodoWrite
```
  跟踪进度
遇到困境时：生成具备
```
Read
```
、
```
Glob
```
、
```
Grep
```
、DeepWiki MCP访问权限的子代理，并加载
```
skills/ask-mcp
```
技能

Domain references

领域参考资料

Task	Reference
Create a mint	create-mint.md
Create SPL interface PDA	create-interface-pda.md
Create associated token account	create-associated-token-account.md
Create token account	create-token-account.md
Mint tokens	mint-to.md
Transfer tokens	transfer-interface.md
Transfer checked	transfer-checked.md
Approve delegate	approve.md
Revoke delegate	revoke.md
Wrap SPL to Light	wrap.md
Unwrap Light to SPL	unwrap.md
Load associated token account	load-associated-token-account.md
Burn tokens	burn.md
Burn checked	burn-checked.md
Freeze token account	freeze.md
Thaw token account	thaw.md
Close token account	close-token-account.md
Mint SPL, wrap, and transfer	spl-mint-wrap-transfer.md

任务	参考资料
创建铸币	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
将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

Operations overview

操作概览

Operation	TypeScript	Rust	Docs
Create Light mint	`createMintInterface`	`CreateMint`	create-mint
Create SPL mint w/ interface PDA	`createMintInterface` + `TOKEN_PROGRAM_ID`	—	create-mint
Create T22 mint w/ interface PDA	`createMintInterface` + `TOKEN_2022_PROGRAM_ID`	—	create-mint
Add interface PDA to existing mint	`createSplInterface`	—	create-mint
Create associated token account	`createAtaInterface`	`CreateAta`	create-ata
Create token account	—	`CreateTokenAccount`	create-token-account
Mint to	`mintToInterface`	`MintTo`	mint-to
Transfer	`transferInterface`	`TransferInterface`	transfer-interface
Transfer checked	—	`TransferChecked`	transfer-checked
Approve	`approve`	`Approve`	approve-revoke
Revoke	`revoke`	`Revoke`	approve-revoke
Burn	—	`Burn`	burn
Burn checked	—	`BurnChecked`	burn
Wrap SPL to Light	`wrap`	`Wrap`	wrap-unwrap
Unwrap Light to SPL	`unwrap`	`Unwrap`	wrap-unwrap
Load associated token account (cold to hot)	`loadAta`	—	load-ata
Freeze	—	`Freeze`	freeze-thaw
Thaw	—	`Thaw`	freeze-thaw
Close	—	`Close`	close-token-account

操作	TypeScript	Rust	文档
创建Light铸币	`createMintInterface`	`CreateMint`	create-mint
创建带接口PDA的SPL铸币	`createMintInterface` + `TOKEN_PROGRAM_ID`	—	create-mint
创建带接口PDA的T22铸币	`createMintInterface` + `TOKEN_2022_PROGRAM_ID`	—	create-mint
为现有铸币添加接口PDA	`createSplInterface`	—	create-mint
创建关联代币账户	`createAtaInterface`	`CreateAta`	create-ata
创建代币账户	—	`CreateTokenAccount`	create-token-account
铸币到账户	`mintToInterface`	`MintTo`	mint-to
转账	`transferInterface`	`TransferInterface`	transfer-interface
校验转账	—	`TransferChecked`	transfer-checked
授权	`approve`	`Approve`	approve-revoke
撤销授权	`revoke`	`Revoke`	approve-revoke
销毁代币	—	`Burn`	burn
校验销毁代币	—	`BurnChecked`	burn
将SPL代币封装为Light代币	`wrap`	`Wrap`	wrap-unwrap
将Light代币解封装为SPL代币	`unwrap`	`Unwrap`	wrap-unwrap
加载关联代币账户（冷转热）	`loadAta`	—	load-ata
冻结账户	—	`Freeze`	freeze-thaw
解冻账户	—	`Thaw`	freeze-thaw
关闭账户	—	`Close`	close-token-account

When to use TypeScript vs Rust

TypeScript与Rust版本的适用场景

Criteria	TypeScript	Rust
Environment	Browser, Node.js, Deno	Server-side, CLI tools, on-chain tests
Package	`@lightprotocol/compressed-token` + `@lightprotocol/stateless.js`	`light_token_client`
Pattern	`await action(rpc, payer, ...)`	`Action::new(...).execute(&mut rpc, &payer).await`
Freeze/Thaw/Close/Burn	Not yet in TS SDK	Available

评估标准	TypeScript	Rust
运行环境	浏览器、Node.js、Deno	服务端、CLI工具、链上测试
依赖包	`@lightprotocol/compressed-token` + `@lightprotocol/stateless.js`	`light_token_client`
代码模式	`await action(rpc, payer, ...)`	`Action::new(...).execute(&mut rpc, &payer).await`
冻结/解冻/关闭账户/销毁代币	TS SDK暂不支持	已支持

External references

外部参考资料

Resource	Link
Docs cookbook	zkcompression.com/light-token/cookbook
TypeScript examples	examples-light-token/typescript-client
Rust examples	examples-light-token/rust-client
`@lightprotocol/stateless.js`	API docs
`@lightprotocol/compressed-token`	API docs
`light-client`	docs.rs
`light-token-client`	docs.rs
`light-token`	docs.rs

资源	链接
官方使用手册	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