@flop-labs/ cli (英语)

FLOP网络CLI——与命令行的FLOP网络节点进行互动.

安装

完整的CLI(钥匙,矿工,验证器和模型命令)需要Node.js 22+. 运行被绑放 从公共 npm 不在全球安装:

npx --yes --package @flop-labs/[email protected] flop --version

或者运行所推广的容器图像,它只需要多克. 对于可复制的消化针, 使用情况 简森。图像起始于 /app因此挂载 您的工作目录并在其中通过绝对路径 :

docker run --rm --network host -v "$PWD:/work" \
  ghcr.io/flop-labs/flop-core/cli:stable \
  --version

npm install --global @flop-labs/cli 也有用,不过还有一点 flop 打开 PATH页:1 hermes发射台下方的公共安装器拒绝安装旁边,两个命令 影相相会.

对于推荐的公有本土 Hermes 提供者路径, 在没有寄存器的情况下安装独立启动器 或软件包注册访问:

curl -fsSL https://flop.network/releases/cli/0.4.11/install.sh | sh -s -- --version 0.4.11
export PATH="$HOME/.local/bin:$PATH"
flop --network devnet hermes desktop --doctor

这个发布需要Node.js 22+,卷曲和合格的赫尔墨斯0.22.2发布. 它包含主机 Hermes命令和本地公共提供者0.1.6并保留现有的完整的CLI. 见 公共发射装置指南docs/integrations/hermes-public-launcher.md fLOP 存储器中)用于 原地设置序列,验收和24小时试验和验收限制. 替代主机发射装置需要为其生成的赫尔墨斯进行明确的准备 a. 家;不合格为在新的管理下的装置上单步发射。 完整的CLI 源构建遗存 :

pnpm install --frozen-lockfile
pnpm --filter @flop-labs/gateway-core build
pnpm --filter @flop-labs/sdk exec tsc
pnpm --filter @flop-labs/sdk run build:a2a-cjs
pnpm --filter @flop-labs/agent-sdk exec tsc
pnpm --filter @flop-labs/cli build
node sdk/cli/dist/cli.js --version # from the repository root

使用量

flop [options] [command]

全球选项

图标

统一角色登入

角色命令为入职,诊断,状态, 和生命周期操作. init 财务报告和审定财务报表 doctor 只读。 诸如 register, (中文(简体) ), calibrate-start, (中文(简体) ), commission, (中文(简体) ), unjail, (中文(简体) ), rejoin,以及 exit 是明显的链子突变.

# Agents: the devnet tailnet MCP is read-only; local mode is signer-capable.
flop --network devnet agent init --client codex
flop --network devnet agent doctor
flop agent launch codex
flop agent proxy
flop agent hermes desktop
flop keys generate --out agent-key.json --password-env FLOP_KEY_PASSWORD
flop agent wallet create <agent-address>
flop agent session create --delegate <address>

# Miners: sim first, measured TDX for verified production, cloud is non-attested.
flop miner init --mode sim
flop miner doctor --mode sim
# A serving miner: chain state plus the public proof gateway admission checks.
# SESSION_AUTH_TOKEN comes from the environment, never the command line.
flop miner doctor --running --session-url http://127.0.0.1:8645/session/info --endpoint https://<miner-host>
flop miner status [address]
flop --signer <MINER-URI> miner register --commission 10
flop --signer <MINER-URI> miner calibrate-start

# Validators: live stake minimum and PoUI-gated committee state are queried.
flop validator init --mode local
flop validator doctor
flop validator status [address]
flop --signer <VALIDATOR-URI> validator register
flop --signer <VALIDATOR-URI> validator commission 10
flop --signer <VALIDATOR-URI> validator unjail
flop --signer <VALIDATOR-URI> validator rejoin
flop --signer <VALIDATOR-URI> validator exit

所有角色规划和诊断命令支助 --json 用于自动化. 全球网络和监管选项在任何筑巢深度都起作用.

网络和水龙头

flop --network devnet network status
flop --network devnet faucet request <address>
flop --network testnet faucet request <address> --amount 25
flop --network mainnet network status       # planned; no faucet

Faucet 请求比较 RPC 和 水龙头 /chain 起源散开之前 要求资金。 承认的《皇家刑法》与明确 --network 实值 拒绝.

具有代理效率的产出

使用 --output agent 对于稳定,单行JSON的结果 没有横幅, emoji,缩进,或成功 doctor 检查 :

flop --output agent miner doctor --mode tdx
flop --output agent validator status <address>
flop --output agent agent init --client codex

成绩包括 ok:true。失败会以非零退出和 紧凑 code, (中文(简体) ), message, (中文(简体) ), retryable选择 next 行动. --json 仍然是落后相容的JSON格式。 互动进程等 作为 launch, (中文(简体) ), proxy后,赫尔墨斯本身保留其应用程序输出 启动; 使用 Hermes --dry-run 用于一发可读的发射计划.

卫生

flop health           # Human-readable
flop health --json    # JSON output

余额

flop balance 5Grwva8T1BQxqNJJM...       # Check account balance
flop balance 5Grwva8... --json             # JSON output

GPU 检测

flop gpu              # Detect local GPUs
flop gpu --json       # JSON output

已申报的GPU库存

nvidia-smi --query-gpu=name,memory.total --format=csv,noheader,nounits > gpus.csv
flop --keystore miner.json --password-env FLOP_KEY_PASSWORD miner declare-gpu --nvidia-smi gpus.csv
flop miner declare-gpu --detect --dry-run   # on the GPU host itself; prints the remark only
flop --keystore miner.json --password-env FLOP_KEY_PASSWORD miner declare-gpu --retract   # withdraw it

一个注册的矿工出版它运行的GPU作为签名 flop.gpu-inventory.v1 备注(格式: docs/design/gpu-inventory-remark.md 在FLOP寄存器中),因此探险家可以显示其硬件. 没错 自报并只显示:校正封顶,SKU天花板和奖励从未读过. 国家行动倡议 图像不能运行主机 nvidia-smi,因此将其输出通过 --nvidia-smi (单位:千美元)- 读取 stdin).

能力预留率

flop miner capacity-rate show [address]      # rate, cap, reserved and free G_n/s at the finalized head
flop --keystore miner.json --password-env FLOP_KEY_PASSWORD miner capacity-rate set 25 --dry-run   # encoded call only
flop --keystore miner.json --password-env FLOP_KEY_PASSWORD miner capacity-rate set 25
flop --keystore miner.json --password-env FLOP_KEY_PASSWORD miner capacity-rate set --whole-cap   # clear it

每个频道对矿工的开通都保留这个费率,从接受的上限到频道 错误; 未设置, 它保留整个封顶, 所以每次只有一个通道适合 . miner-worker 保留  floor(cap / MINER_MAX_CONCURRENT_SESSIONS) 除非你设置了一个更低的。 呼叫只存在 - 命令拒绝.

获取信息

flop info 5Grwva8...  # Get miner stake info

会话密钥

flop session create --delegate <address> --daily-cap 50 --tx-limit 5
flop session list --owner <address>
flop --signer <DELEGATE-URI> chat --session-owner <OWNER> "hello"
flop --signer <DELEGATE-URI> proxy --session-owner <OWNER>

会期推断活动、到期和每日/周期预算, 然后通过 executeViaSession。 。 。 . chat 持续对话 标识和支持 --conversation, (中文(简体) ), --history,以及 --delete。 。 。 .

命名最小推论

flop --network devnet --keystore agent.json --password-env FLOP_KEY_PASSWORD \
  session run --miner MINER_SS58 --model qwen/qwen2.5-0.5b-instruct \
  --endpoint MINER_HTTPS_URL --prompt 'Reply OK.' --max-flop 0.01 --max-tokens 8 --json

完成限制默认为256个令牌. --max-tokens 一定是正保险箱 整数; --max-flop 分隔代管。 JSON包括: finish_reason 财务报告和审定财务报表 completion_tokens· ; length 表示响应达到了其符号极限. 转弯 截止时间仍为60秒,所以大的符号限制或缓慢的推论仍然可以持续时间 关闭并跟踪正常的频道恢复。 分开解决 等待矿工 (b) 更快的推断不能绕过这一限制。 遗产矿工可能需要 --auth-token-env MINER_SESSION_BEARER。 。 。 .

模型

flop model list
flop model get <hash-or-name> --precision FP16
flop model fetch <hash-or-name> --output-dir ./weights
flop model fetch <hash> --source hf:org/repo --precision INT8
flop model fetch <hash> --revision <40-hex sha> --output-dir ./weights
flop --signer <PUBLISHER> model upload --model-hash <hash> --path ./weights
flop --signer <PUBLISHER> model mirrors set --model-hash <hash> --append --source da:<table> --dry-run
BASE=http://miner:8000 DECODE_POLICY_HASH=0x<hash> \
  flop --network local model onboard --source org/model --precision BF16

# Existing-commitment recovery/advanced mode:
flop --signer <PUBLISHER> model upload \
  --model-hash <hash> --commitment <0x-hash> --size <bytes>

获取接受 hf:, (中文(简体) ), modelscope:,HTTPS,和 da: 来源和只写 dm-verity 匹配已注册根后。 单向一时的一面相机 承诺: --revision <sha> 把它钉上,没有它 main 仅当其 sha256表复制a content-v1 根数( e)upload --source hf: 同样;见 docs/onboarding/model.md) (中文(简体) ). 完整上传 构建 Canonial 图像, 运行 da-validator submit登记它租来的地盘 把它绑起来. 机上额外登记模型,镜像,精度测量根, 并解码政策,但只有在 服务终点通过捕获回放, 装订拒绝,和输出协调探测器。 重运行它不会提交信件 . --hf-repo owner/model 给一个本地 --source a 拥抱相貌镜,但仅限 复出后再复制被测量的根. 重新运行时添加了镜像 到一个已经注册的模型.

网关配置

export MINER_GATEWAY_TOKEN='from-a-secret-manager'
flop gateway allowlist \
  --miner https://miner.example \
  --network devnet \
  --auth-token-env MINER_GATEWAY_TOKEN \
  --attestation ./gateway-attestation.json \
  --json

命令已准备就绪 GATEWAY_SESSION_ALLOWLIST 财务报告和审定财务报表 GATEWAY_MODEL_CATALOG 字符串值。 选定网络提供 RPC 默认。 匿名探测 /session/info 首先要求持证人, 然后检查每个公布的身份字段 model-registry,包括: 测量根和解码政策许可列表,并检查矿工的校正 对定案 hw-calibration 示意图.

证明文件的使用 schema_version: "flop.gateway-attestation.v1" 财务报告和审定财务报表 包含 broker 限制, deployment 证据,以及 catalog 证据。 这个 目录块是一个 CanonicalModelRecord 没有生成的身份字段 或者说 prices它携带一个 price 换成快照 部署 observedAt编号 :expiresAt,目录价格有效性,特征符合 使用不变。 过期证据被拒绝,而不是被刷新.

# GATEWAY_SESSION_ALLOWLIST / GATEWAY_MODEL_CATALOG hold the gateway's own values.
export GPUAI_API_KEY='from-a-secret-manager'
export GATEWAY_RENEWER_SIGNER_URI='dedicated funded account, not the broker signer'
flop --network devnet gateway renew \
  --allowlist-env GATEWAY_SESSION_ALLOWLIST \
  --catalog-env GATEWAY_MODEL_CATALOG --catalog-pricing chain \
  --provider-key-env GPUAI_API_KEY \
  --probe-signer-env GATEWAY_RENEWER_SIGNER_URI --probe-escrow 1 \
  --out /opt/flop/gateway-evidence/gateway-evidence.json

gateway renew {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}然后写着 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080} 文件网关热重装为 GATEWAY_EVIDENCE_FILE一个矿工 只有在 GPU.ai 仍然报告该实例时才会更新部署 deployment.source (单位:千美元)operator-observed:gpu.ai/<instance> <region> <gpu>, (中文(简体) ), 随附 (label),作为 running 在那个地区的GPU。 这个 GPU是GPU.ai的标识符(rtx_a6000)或它在GPU.ai的GPU类型表格中的名称 (单位:千美元)RTX A6000,有或无 NVIDIA; 任何其他名称不续用. A 类 尾网托管矿工operator-observed:tailscale/<host> egress <ipv4> AS<n>, (中文(简体) ), 网络名称和a (label)) 仅在 主机尾缩放( n)--tailscale-socket在网上看到这个名字的一个节点, 标记 tag:miner,直接走出该 " egress " 地址 因此,该地址仍然保留。 认证 /session/info 还必须在被封住的地址上做广告, 飞地钥匙和身份 最终的链条仍然承认。 记录 tools 只有通过 一个真正的计算通道转弯, 从探测器的代管人支付 框带 a lookup 带有 JSON 的工具调用 query。每次更新都保持其 已声明窗口长度 。 所有其他声称的特征 还没有探测和失效. 没有续约的都从档案中遗漏出来,在申报时失效 过期。 命令退出 1 当任何事项失效, 并且从未打印许可列表 . 在每一次探测前,都需要一次 --probe-escrow 探测器上的免费 最终头部。 当签字人持少, 没有进一步的探测器运行, Stderr说 gateway renew: PROBE SIGNER UNDERFUNDED: …。 。 。 . GPU.ai 单声道响应形状(status, (中文(简体) ), region, (中文(简体) ), gpu_type)为 从定价中假设并创建 API,所以观看第一次运行.

操作员可以公布已结算的拥有者要求的工具资格 不创建另一个探测器或使用直接更新器的签名人/提供者证书:

flop --network devnet gateway renew \
  --catalog-env GATEWAY_MODEL_CATALOG --catalog-pricing chain \
  --qualification-receipt ./settled-tools-qualification.json \
  --qualification-receipt-sha256 "$QUALIFICATION_RECEIPT_SHA256" \
  --out /opt/flop/gateway-evidence/gateway-evidence.json

散列必须识别准确的不可变的收件字节. 只接收模式拒绝 直接测试选项。 它验证原始所有者/居民/用途信封,签名 转接/前置/ACK和警犬最后确定正结算,然后将一个通行证附加到 现有证据文件。 它保留了无关的部署和符合规定的条目, 保留校准的原始探测时间和已宣布窗口,并拒绝 互相矛盾的重新出版。 相同的收据是没有的。 同时 gateway renew 命令使用此版本使用独有的出版锁定; 冲突作者 失败而不是替换其内容。 必须协调老作家或无关作家 分别。 只收出版物只保留该制作人最新的未过期通行证 保存其原始时间和所有无关的证据. 在写作时杀死的进程可以离开 OUT.lock; 确认作者已停止 手动恢复那个锁, 永远不要去掉另一个活跃的作者的锁. 不得再推论、代管、提交签字或自动公布 资格结束点。 普通聊天继续需要新工具 招生; 资格申请不是允许任意运行 stale-tools 聊天.

钥匙、硬件、多西格和空接签名

export FLOP_KEY_PASSWORD='from-a-secret-manager'
flop keys generate --name treasury --out treasury.json \
  --password-env FLOP_KEY_PASSWORD
export FLOP_IMPORTED_SECRET='mnemonic from a secret manager'
flop keys import --secret-env FLOP_IMPORTED_SECRET --out imported.json \
  --password-env FLOP_KEY_PASSWORD
flop keys export treasury.json --source-password-env FLOP_KEY_PASSWORD \
  --out treasury-backup.json --password-env FLOP_BACKUP_PASSWORD
flop keys inspect treasury.json
flop keys hardware

flop multisig address --threshold 2 --signatory <A> <B> <C>
flop --keystore treasury.json --password-env FLOP_KEY_PASSWORD \
  multisig propose --threshold 2 --other <B> <C> --call <0x-call>
flop multisig list --account <MULTISIG>

flop tx build --address <ADDRESS> --call <0x-call> \
  --out unsigned.json --qr
flop tx broadcast unsigned.json --signature <0x-multisignature>

tx build pins 起源、运行时间、交易版本和非ce。 广播 拒绝漂移。 终端 QR 使用可选 qrencodeJSON信封有用吗 带有 Polkadot 空洞、 硬件钱包、 HSM/ MPC 保管器, 或其他分离器 签名者.

钱包

flop wallet agent create <agent-address> --daily-cap 50 --tx-limit 5

共享脱网代理证书

为任何支持的代理客户端提供一键而不启动赫尔墨斯:

flop --network devnet agent credential           # path, live model, quota; no bearer
flop --network devnet agent credential --json    # non-secret metadata
flop --network devnet agent credential --print-key # secret on stdout for local auth helpers
flop --network devnet agent credential --tailnet # private lane for approved Tailscale users

命令需要明确 --network devnet。默认情况下,它将在 公共网关 https://api.flop.network 带有钱包签名。 在第一次使用时 它在 ~/.flop/devnet-enroll-wallet.json (未加密,只有devnet,模式0600;其秘密从未被打印出). 如果是这样 账户持有量低于1 FLOP, 它要求从 https://faucet.flop.network/fund 并等待补助金最后确定 wss://rpc.devnet.flop.network (单位:千美元)--rpc (原始内容存档于2017-03-25). overse. 然后签下 网关单用挑战. 密钥被缓存于 ~/.flop/devnet-wallet-agent-key.json经营者必须明确资助和配置津贴;建议 临时使用补助金为20,000德文FLOP, 范围为: 入学,24小时内期满。 重新注册 持单人轮换,但绝不延长配额或期满.

--tailnet 保留私人专用道,供经批准的Tailscale用户使用。 它的注册在 http://gateway.ts.flop.network:3201/enroll 并给养七日, 缓存于 ~/.flop/devnet-agent-key.json 与赫尔墨斯供养者分享. 两个缓存都是POSIX系统上一个模式-0700目录中的0600模式. A 类 .lock 每一个缓存目录都会对本地客户端的注册进行序列化 。 这个 --print-key 形式刻意明确; 重新定向或私下消耗 而不是记录终端输出。 烂透了 .lock 崩溃后的目录 只有在确认没有进行注册后才能删除.

flop --network devnet agent init 财务报告和审定财务报表 agent doctor 利用公众 https://mcp.flop.network/mcp 默认只读服务; 通过 --mcp-url 瞄准另一个经核实的终点.

赫尔墨斯桌面

当地公共提供者(sdk/hermes_public与 独立发射器0.4.5. 使用 flop hermes plugin install 在一个孤立的 HERMES_HOME 之后 hermes pm repair,则 hermes auth add flop-public, (中文(简体) ), hermes model 财务报告和审定财务报表 hermes desktop单独的私人提供者(sdk/hermes_native(中文(简体) ) 需要经批准的Tailscale身份和FLOP寄存器访问. 遵循公共本地设置指南(docs/integrations/hermes-public-launcher.md, (中文(简体) ), 推荐公用路线的"国内公用提供者"). 完整的CLI也保留了私有的尾网道:

flop --network devnet hermes desktop --dry-run --json # inspect without provisioning
flop --network devnet hermes desktop --gateway http://gateway.ts.flop.network # tailnet lane

从源检出, 替换 flop 与 node sdk/cli/dist/cli.js 之后 上面的建筑. 替代公共主机发射装置需要有管理的家用准备 在公共指南中; 立即启动桌面不合格。 与 尾声网 --gateway中,必须先批准您的 Tailscale 用户 ID; 以 访问请求然后,CLI获得7天、25个FLOP模型范围津贴和 将密钥存储在 ~/.flop/devnet-agent-key.json (第0600节). 日后发射 以及其它本地代理客户端检查并再使用缓存密钥. 如果本地密钥丢失或拒绝, 注册者在保存时旋转 其支出额和到期日。 用尽、过期和被吊销津贴 操作员可以更新或重新验证它们。 普通 CLI 输出不打印密钥 .

无 --network devnet,命令会像以前一样启动嵌入式签名器代理 :

flop hermes desktop                                  # embedded proxy + launch Hermes
flop --signer //Bob hermes desktop                   # settle under //Bob
flop hermes desktop --model llama-3-8b-instruct --max-flop 10 --max-tokens 4096
flop hermes desktop --proxy-port 1234                # embedded proxy on a custom port
flop --network devnet --signer "$FLOP_SIGNER" hermes desktop --proxy # funded signer
flop hermes desktop --configure                      # also persist via `hermes config set`
flop hermes desktop --no-proxy \
  --gateway http://gateway.ts.flop.network --model "$FLOP_MODEL"
flop hermes desktop --dry-run --json                 # print resolved env/launch plan, don't launch

它通过env vars Hermes读取一个自定义将Hermes接入嵌入式代理 OpenAI相容的终点—— OPENAI_BASE_URL (- 代理 /v1, (中文(简体) ), OPENAI_API_KEY, (中文(简体) ), 财务报告和审定财务报表 HERMES_INFERENCE_MODEL (单位:千美元)api_mode 自动检测 chat_completions) ——加 FLOP_WS_URL编号 :FLOP_SIGNER 联 合 国 @flop-labs/hermes-plugin。 。 。 . --configure 继续通过真实的线条 hermes config set 国 际 (单位:千美元)model.provider=custom, (中文(简体) ), model.base_url, (中文(简体) ), model.api_mode, (中文(简体) ), model.default) (中文(简体) ). 需要 Hermes 二进制 (hermes-desktop 或者说 hermes继续 PATH; 使用 --dry-run 检查没有它。 自定义主机 --gateway 需求 FLOP_API_KEY 私人和明确 --model 从现场 目录. CLI检查网关健康、模式可用性和关键有效性 在发射前 私人的devnet网关只能从 FLOP 进入 尾声网.

本地 OpenAI 代理服务器

曝光本地 OpenAI 兼容 API( 如 LM Studio / Ollama 本地服务器) 地点 每一份请求都在您的签名人名下提交和解决。 。 。 . 代理估计值 G n, 提交 PoI 任务, 等待 TEE 矿工解决 ,然后返回结果 —— 全部在 OpenAI REST 计划后面 :

flop proxy                                   # http://127.0.0.1:3201/v1
flop --signer //Bob proxy --max-flop 10
flop proxy --port 1234 --host 0.0.0.0        # expose beyond localhost

嵌入层 是一个廉价的高频RAG原始,不需要在链上 和解,所以代理计算 当地 带有小型嵌入模型 (默认) Xenova/all-MiniLM-L6-v2, L2 正常输出, 如 Ollama /api/embed) (中文(简体) ). 这需要可选的运行时间依赖性——安装一次:

pnpm add @huggingface/transformers

没有它, /v1/embeddings 返回时 501 使用此提示( 聊天/ 补全为 (不受影响)。 以 --embedding-model <hf-id>。 。 。 .

流线 : stream: true 返回 OpenAI SSE 块(data: {…} . data: [DONE], (中文(简体) ), 包括通过 stream_options.include_usageFLOP 解决 解剖任务,所以这是 清算时流: 正在等待结果, 那么 以块形式排放(纬度至先入位=结算时间),而非递增 矿工一代.

型号: /v1/models 反映有效载荷网关登记册 (单位:千美元)<payload-gateway>/v1/models),如果是,则会回到内置默认值 不可通达.

选项 : --port (3201), (中文(简体) ), --host (127.0.0.1) (中文(简体) ), --payload-gateway (脱链即时/结果数据平面,默认值) http://localhost:3200, (中文(简体) ), --model, (中文(简体) ), --max-tokens (违约2048), --max-flop全球用途 --rpc编号 :--signer。指向任何 OpenAI 客户端 OPENAI_BASE_URL=http://127.0.0.1:3201/v1。 。 。 .

建筑

• 由指挥官.js建造
• 通过 "@flop-labs/sdk": "file:../typescript"
• 带有 ES 模块的脚本类型,通过 tsc
• 所有命令都使用 FlopClient.create() 从SDK与 --rpc 财务报告和审定财务报表 --signer 全球选项
• 角色组 重用已有的启动,代理,密钥,钱包,会话, schoing, TDX, 和提供者的工作流程,而不是引入平行实施.

运算符图像: 使用 ghcr.io/flop-labs/flop-core/cli:stable (最低为0.1.272), ghcr.io/flop-labs/flop-core/miner-worker:stable (至少0.172)和 ghcr.io/flop-labs/flop-core/miner-vllm-toploc:stable (最低为0.1172). 对于可复制的针头,请使用版本和摘要 简森。 。 。 . just miner-pack /tmp/flop-miner-pack 对照最小值检查、复制和设定图像 :stable。 。 。 . 包是公用路线,没有尾网:公共RPC,邮箱和赞助商,以及 docker-compose.tls.yml 用于会话结束点.