gen-paylink-govilo

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Govilo To Go

Govilo To Go

Turn any file into a paid unlock link — one command to package, upload, and collect crypto payments. The last mile of automation: from creation to monetization.
将任意文件转换为付费解锁链接——只需一条命令即可完成打包、上传并收取加密货币付款。实现从内容创建到变现的最后一英里自动化。

Before Running

运行前准备

Always ask the user for these values before executing the CLI — never guess or use placeholders:
  1. title — What is the product name?
  2. price — How much to charge (in USDC)?
  3. description — Short description of the product (optional, but always ask)
在执行CLI命令前,务必向用户确认以下参数——切勿猜测或使用占位符:
  1. title — 产品名称是什么?
  2. price — 收费金额(以USDC计价)?
  3. description — 产品简短描述(可选,但务必询问)

CLI Command

CLI命令

Requires uv. See references/setup-guide.md for install instructions.
Run from this skill's base directory. Use a dedicated env file containing only
GOVILO_API_KEY
(and optionally
SELLER_ADDRESS
). Never point
--env-file
at a project
.env
that contains unrelated secrets.
bash
cd <skill_base_directory>
uv run --env-file <path_to>/.env.govilo create-link \
  --input <path>         \
  --title "Product Name" \
  --price "5.00"         \
  --address "0x..."      \
  --description "optional"
If no
.env.govilo
exists, create one before running:
dotenv
GOVILO_API_KEY=sk_live_xxx
SELLER_ADDRESS=0x...
--input
accepts ZIP file, folder, or individual files (repeatable). Non-ZIP inputs are auto-packaged.
All output is JSON
{"ok": true/false, ...}
with exit code 1 on failure.
需要依赖uv。安装说明请查看references/setup-guide.md
请在本技能的根目录下运行命令。使用专用的环境变量文件,该文件仅包含
GOVILO_API_KEY
(可选包含
SELLER_ADDRESS
)。切勿将
--env-file
指向包含无关密钥的项目
.env
文件。
bash
cd <skill_base_directory>
uv run --env-file <path_to>/.env.govilo create-link \
  --input <path>         \
  --title "产品名称" \
  --price "5.00"         \
  --address "0x..."      \
  --description "可选描述"
若不存在
.env.govilo
文件,请在运行前创建:
dotenv
GOVILO_API_KEY=sk_live_xxx
SELLER_ADDRESS=0x...
--input
参数支持ZIP文件、文件夹或单个文件(可重复使用)。非ZIP格式的输入将自动打包为ZIP。
所有输出均为JSON格式
{"ok": true/false, ...}
,执行失败时退出码为1。

Parameters

参数说明

ParamRequiredSourceDescription
--input
YesCLI (repeatable)ZIP, folder, or file paths
--title
YesCLIProduct title
--price
YesCLIPrice in USDC
--address
NoCLI >
SELLER_ADDRESS
env
Seller EVM wallet
--description
NoCLIProduct description
参数名称是否必填参数来源描述
--input
CLI(可重复使用)ZIP文件、文件夹或文件路径
--title
CLI产品标题
--price
CLI以USDC计价的价格
--address
CLI >
SELLER_ADDRESS
环境变量
卖家EVM钱包地址
--description
CLI产品描述

Workflow

工作流程

  1. Validate config (API Key + seller address)
  2. Package inputs → ZIP (if not already ZIP)
  3. POST /api/v1/bot/uploads/presign
    → get upload_url + session_id
  4. PUT upload_url
    → upload ZIP to R2
  5. POST /api/v1/bot/items
    → get unlock_url
  1. 验证配置信息(API密钥 + 卖家地址)
  2. 将输入内容打包为ZIP(若输入不是ZIP格式)
  3. 调用
    POST /api/v1/bot/uploads/presign
    接口 → 获取upload_url和session_id
  4. 调用
    PUT upload_url
    接口 → 将ZIP文件上传至R2存储
  5. 调用
    POST /api/v1/bot/items
    接口 → 获取unlock_url

File Limits

文件限制

  • Max ZIP size: 20 MB
  • Max files in ZIP: 20
  • ZIP文件最大大小:20 MB
  • ZIP文件内最多包含20个文件

Setup

配置步骤

Two values are required:
VariableRequiredDescription
GOVILO_API_KEY
YesBot API key from govilo.xyz
SELLER_ADDRESS
Yes*EVM wallet address on Base chain
*
SELLER_ADDRESS
can also be passed via
--address
CLI parameter.
See references/setup-guide.md for step-by-step registration and wallet setup instructions.
需要配置以下两个参数:
变量名称是否必填描述
GOVILO_API_KEY
govilo.xyz获取的Bot API密钥
SELLER_ADDRESS
是*Base链上的EVM钱包地址
*
SELLER_ADDRESS
也可通过
--address
CLI参数传入。
分步注册和钱包配置说明请查看references/setup-guide.md

API Reference

API参考

See references/bot-api-quick-ref.md for Bot API endpoints and error codes.
Bot API的接口端点和错误码请查看references/bot-api-quick-ref.md