API Reference

OmniClaw Client

Initialization

from omniclaw import OmniClaw, Network
client = OmniClaw(
 network=Network.BASE_SEPOLIA, # or Network.BASE_MAINNET
 circle_api_key="...", # optional, reads from env
 entity_secret="..." # optional, reads from env
)

Wallet Management

create_wallet()

wallet = client.create_wallet()
print(wallet.id, wallet.address)

get_wallet(wallet_id)

wallet = client.get_wallet("wallet-uuid")

Payment Operations

pay()

result = client.pay(
 wallet_id="sender-wallet-id",
 to="recipient-address",
 amount=10.00,
 token="USDC" # default
)

simulate()

sim = client.simulate(
 wallet_id="sender-wallet-id",
 to="recipient-address",
 amount=10.00
)
if sim.success:
 # Safe to proceed
 client.pay(...)
else:
 print(sim.error)

Seller SDK

sell() Decorator

from omniclaw import sell
@sell(price=0.01, token="USDC")
async def my_endpoint(request):
 return {"data": "premium content"}

Seller Configuration

from omniclaw.seller import Seller
seller = Seller(
 wallet_id="merchant-wallet-id",
 network=Network.BASE_SEPOLIA
)

NanoPayment

from omniclaw.nanopayment import NanoPayment
nano = NanoPayment(network=Network.BASE_SEPOLIA)
result = nano.transfer(
 from_wallet="sender-id",
 to="recipient-address",
 amount=0.001 # micro-amounts supported
)

Trust Evaluation

from omniclaw.trust import TrustEvaluator
evaluator = TrustEvaluator()
score = evaluator.evaluate(
 agent_id="agent-address",
 context={"transaction_amount": 100.00}
)
print(score.trust_level) # e.g., "high", "medium", "low"
print(score.signals) # contributing trust signals

CLI Commands

Further Reading