slot-paymaster

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Slot Paymaster

Slot Paymaster

Manage paymasters that sponsor transaction fees, enabling gasless experiences for users. Zero integration required — when enabled, eligible transactions are automatically sponsored.
管理用于承担交易手续费的Paymaster,为用户实现免Gas费的体验。 无需集成——启用后,符合条件的交易将自动获得手续费赞助。

Availability

可用环境

  • Testnet: Automatically enabled, no setup required
  • Mainnet: Self-served via Slot CLI
  • 测试网:自动启用,无需设置
  • 主网:通过Slot CLI自助配置

Creating a Paymaster

创建Paymaster

Requires an authenticated session (
slot auth login
) and a team with credits.
sh
slot paymaster <name> create --team <team> --budget <amount> --unit CREDIT
The budget is deducted from the team's credit balance. 1 CREDIT = $0.01 USD.
需要已认证的会话(
slot auth login
)以及拥有可用额度的团队。
sh
slot paymaster <name> create --team <team> --budget <amount> --unit CREDIT
预算将从团队的额度余额中扣除。 1 CREDIT = 0.01美元。

Budget Management

预算管理

sh
undefined
sh
undefined

Increase budget

增加预算

slot paymaster <name> budget increase --amount <amount> --unit CREDIT
slot paymaster <name> budget increase --amount <amount> --unit CREDIT

Decrease budget

减少预算

slot paymaster <name> budget decrease --amount <amount> --unit CREDIT
undefined
slot paymaster <name> budget decrease --amount <amount> --unit CREDIT
undefined

Policy Management

策略管理

Policies define which contracts and entrypoints the paymaster will sponsor.
策略定义了Paymaster将为哪些合约和入口点提供手续费赞助。

Add from preset (recommended)

从预设添加(推荐)

Use verified contract presets from the Dojo ecosystem:
sh
slot paymaster <name> policy add-from-preset --name <preset-name>
使用Dojo生态中的已验证合约预设:
sh
slot paymaster <name> policy add-from-preset --name <preset-name>

Add a single policy

添加单个策略

sh
slot paymaster <name> policy add --contract <address> --entrypoint <entry-point>
sh
slot paymaster <name> policy add --contract <address> --entrypoint <entry-point>

Add from JSON

从JSON添加

sh
slot paymaster <name> policy add-from-json --file <path>
JSON format:
json
[
  {
    "contractAddress": "0x1234...abcd",
    "entrypoint": "move_player"
  },
  {
    "contractAddress": "0x5678...efgh",
    "entrypoint": "attack",
    "predicate": {
      "address": "0x9abc...1234",
      "entrypoint": "check_attack_eligibility"
    }
  }
]
Predicates are optional. When present, the predicate contract is called first — the transaction is only sponsored if it returns
true
.
sh
slot paymaster <name> policy add-from-json --file <path>
JSON格式:
json
[
  {
    "contractAddress": "0x1234...abcd",
    "entrypoint": "move_player"
  },
  {
    "contractAddress": "0x5678...efgh",
    "entrypoint": "attack",
    "predicate": {
      "address": "0x9abc...1234",
      "entrypoint": "check_attack_eligibility"
    }
  }
]
Predicate为可选配置。 当配置Predicate时,会先调用该合约——只有当合约返回
true
时,交易才会获得手续费赞助。

Remove policies

删除策略

sh
undefined
sh
undefined

Remove one

删除单个策略

slot paymaster <name> policy remove --contract <address> --entrypoint <entry-point>
slot paymaster <name> policy remove --contract <address> --entrypoint <entry-point>

Remove all (requires confirmation)

删除所有策略(需要确认)

slot paymaster <name> policy remove-all
slot paymaster <name> policy remove-all

List current policies

列出当前策略

slot paymaster <name> policy list
undefined
slot paymaster <name> policy list
undefined

Info and Configuration

信息与配置

sh
undefined
sh
undefined

View paymaster details, budget, and policy count

查看Paymaster详情、预算及策略数量

slot paymaster <name> info
slot paymaster <name> info

Rename

重命名

slot paymaster <name> update --name <new-name>
slot paymaster <name> update --name <new-name>

Transfer to different team

转移至其他团队

slot paymaster <name> update --team <new-team>
slot paymaster <name> update --team <new-team>

Enable/disable

启用/禁用

slot paymaster <name> update --active false slot paymaster <name> update --active true
undefined
slot paymaster <name> update --active false slot paymaster <name> update --active true
undefined

Monitoring

监控

Stats

统计数据

sh
slot paymaster <name> stats --last <period>
Period options:
1hr
,
2hr
,
24hr
,
1day
,
2day
,
7day
,
1week
.
sh
slot paymaster <name> stats --last <period>
时间周期选项:
1hr
2hr
24hr
1day
2day
7day
1week

Transaction history

交易历史

sh
slot paymaster <name> transactions [OPTIONS]
Options:
  • --filter SUCCESS|REVERTED|ALL
  • --last <period>
  • --order-by FEES_ASC|FEES_DESC|EXECUTED_AT_DESC|EXECUTED_AT_ASC
  • --limit <n>
    (max 1000)
sh
slot paymaster <name> transactions [OPTIONS]
选项:
  • --filter SUCCESS|REVERTED|ALL
  • --last <period>
  • --order-by FEES_ASC|FEES_DESC|EXECUTED_AT_DESC|EXECUTED_AT_ASC
  • --limit <n>
    (最大1000)

Dune Analytics

Dune Analytics

Generate SQL queries for Dune dashboards:
sh
undefined
生成用于Dune仪表板的SQL查询:
sh
undefined

With actual timestamps

带实际时间戳

slot paymaster <name> dune --last 24hr
slot paymaster <name> dune --last 24hr

With template parameters for Dune dashboards

带Dune仪表板模板参数

slot paymaster <name> dune --dune-params
undefined
slot paymaster <name> dune --dune-params
undefined

Common Workflow: New Game Setup

常见工作流:新游戏设置

sh
undefined
sh
undefined

Create paymaster

创建Paymaster

slot paymaster my-game-pm create --team my-team --budget 1000 --unit CREDIT
slot paymaster my-game-pm create --team my-team --budget 1000 --unit CREDIT

Add game contract policies

添加游戏合约策略

slot paymaster my-game-pm policy add --contract 0x123...abc --entrypoint move_player slot paymaster my-game-pm policy add --contract 0x123...abc --entrypoint attack_enemy
slot paymaster my-game-pm policy add --contract 0x123...abc --entrypoint move_player slot paymaster my-game-pm policy add --contract 0x123...abc --entrypoint attack_enemy

Verify setup

验证设置

slot paymaster my-game-pm info
undefined
slot paymaster my-game-pm info
undefined