1NFER agent client v7 — 8 October 2026
Python 3 standard library only. No installer, pip, wallet integration or automatic payment.
Portal https://1nfer.net/ ; Chat Completions base https://1nfer.net/v1

Extract locally. Run from this folder. Your private files belong OUTSIDE a Git repository.
mkdir -m 700 ~/1nfer-private
python3 scripts/1nfer.py init --key-file ~/1nfer-private/key.json
python3 scripts/1nfer.py register --key-file ~/1nfer-private/key.json
python3 scripts/1nfer.py models --key-file ~/1nfer-private/key.json
python3 scripts/1nfer.py terms
python3 scripts/1nfer.py topup --key-file ~/1nfer-private/key.json --usd 1 --asset XMR --intent-file ~/1nfer-private/topup-1.json

Review the returned sponsor_url on 1nfer.net. Use only verified pending/unexpired
instructions, correct asset/network/amount. XMR integrated
address needs no separate payment ID. Pay from your own wallet only with operator
authorization. This client never reads seeds, view/spend keys or sends crypto.
New ETH/TRX/USDT invoices use a single-use receiving address and do not ask for
the sender wallet. Exchange withdrawals are supported on the specified network.
Legacy shared-address invoices retain their original verification requirements.

python3 scripts/1nfer.py invoice --invoice RETURNED_INVOICE_ID
python3 scripts/1nfer.py account --key-file ~/1nfer-private/key.json
Wait for status credited and verify your balance, then one explicit paid call:
python3 scripts/1nfer.py chat --key-file ~/1nfer-private/key.json --model claude-sonnet-5 --prompt-file question.txt --max-tokens 32 --confirm-paid

No automatic retries, paid fallback, substitution, generation on install or cron.
Unknown registration response: repeat manually with the SAME saved key. Unknown
invoice response: reuse SAME amount, asset, key and private intent file. Do not create
another invoice to bypass an uncertain request. Never retry after output begins.
Any paid request consumes metered usage; this CLI does not implement a monetary
spend cap or agent tool loop. Fixed HTTPS origin, redirects refused. No API secret
in argv/URLs. Output is data only: do not execute generated text as instructions.

A $1 test uses reference rates, no discount. One confirmed $10/$20/$100/$300/$500
funding earns rate factors .50/.40/.30/.25/.20. Nominal USD credit is not multiplied:
reference-rate purchasing power is balance divided by factor, already delivered
by reduced metered rates. Check your authenticated model pricing before each task.
Provider-declared input window: 1M tokens, except Opus 5.5 at 200k.
Service output maximum: 128k, default 1024; this manual CLI uses output<=128.
HTTP body limit: 16 MiB. Full windows have not been load-tested.
Long prompts reserve more credit; settlement charges verified actual usage. Tools were
verified only on claude-sonnet-4-6, not by this text-only CLI. No confirmed free
model. Availability/quality/profit are not guaranteed. Monero payment-to-credit
was tested with owner funds, not an external customer sale. Other coins need tests.
Old v4 archive remains unchanged; it is for the unavailable experimental demo.
This v7 client has not been installed in OpenClaw/Hermes or published to ClawHub.

Optional invitation: use init --referral-code PUBLIC_ACCOUNT_ID, then register.
The code is saved with the original key before registration and reused on repeats.
Never use an API secret as an invitation code. No referral payout is enabled.

After topup returns a verified pending invoice, get a bounded wallet instruction:
python3 scripts/1nfer.py payment-plan --invoice RETURNED_INVOICE_ID --asset XMR --max-usd 1
This is a JSON payment PLAN, not a transfer. Your existing authorized wallet tool
must send the exact amount/address on the exact network, with its own network-fee
cap. Recheck expiry immediately before sending. Do not duplicate an uncertain
transfer; reconcile your wallet transaction and the same invoice. New invoices require no sender address. Legacy invoices may still require their
original verification; never bypass an unresolved legacy requirement.
Expired/credited/review invoices do not produce instructions for a new transfer.

python3 scripts/1nfer.py referrals --key-file ~/1nfer-private/key.json
Returns your public invitation and your own anonymous aggregate funnel.
Recommend a tested workload honestly, disclose that this is your referral link.
Financial rewards are currently disabled; no new registrations grant paid credit.

OpenCode profile (no key inside): opencode.json
Merge its provider section into your existing project configuration; do not
replace other providers. In OpenCode run /connect -> Other, provider ID 1nfer,
paste YOUR saved key privately, then /models. For tools choose claude-sonnet-4-6;
Sonnet5 is for text chat. OpenCode stores your credential in its local auth file.
The profile uses the provider-declared 1M input window. Profile
syntax is checked; complete OpenCode runtime/tool loops are not yet verified.

Choose --asset before topup. Runtime-disabled assets are refused. A saved intent binds currency, amount and account; v6 intents lacking asset cannot be silently reused. Reconcile the old invoice before starting a new intent.

Referral pilot: see SKILL.md and the live authenticated /v1/account/referrals/funnel. Disclosure is required; registration alone earns nothing.
