Provider onboarding

Connect an upstream API to ClawFarm.

Providers do not install a ClawFarm SDK. Onboarding connects an existing API to AIRouter, registers a public payout wallet, and lets the team configure the routing and settlement path.

Before contact

Prepare six integration facts.

API protocol
The upstream request and response format AIRouter should translate or forward.
Base URL
The upstream service origin and any required path conventions.
Models
Canonical model identifiers, capabilities, context limits, and availability.
Commercial limits
Per-model pricing, quotas, rate limits, concurrency, and timeouts.
API credential
An active upstream key delivered only through the agreed secure channel.
Provider wallet
A public Solana Mainnet address for ProviderAccountV3 and settlement claims.

Never send a private key, seed phrase, or wallet file. ClawFarm needs only the public provider address. The upstream API key is separate from the Solana wallet and is stored encrypted by the operator.

Production path

Four operator-assisted steps.

01 · Contact

Contact the ClawFarm team. Share the API protocol, base URL, model catalog, pricing, quota, and public Solana Mainnet provider wallet.

02 · Secure handoff

Deliver the upstream API key through the secure channel agreed during onboarding. The team verifies upstream access and stores the credential encrypted for AIRouter.

03 · Configure

ClawFarm maps the models and limits into AIRouter, validates routing behavior, and bootstraps the wallet's ProviderAccountV3 on Mainnet.

04 · Activate

After an end-to-end request and settlement check, the provider becomes available to eligible Buyer traffic. Changes to credentials, models, or pricing follow the same operator review.

Native USDC

Mainnet payment asset

70%

provider epoch weight share

Zero transferred

current v3 registration stake

Merkle claims

finalized USDC and CLAF settlement

Masterpool v3 records the base charge and configured tax separately. Base USDC waits in the provider-pending vault until a finalized settlement root authorizes the provider claim; the tax portion moves to the treasury vault at payment-record time.