[Public Agent Network]: Direct contract-backed launch SDK

[FlowmemoryAI]

Goal

Build the direct SDK path for signing and submitting public agent and swarm launches against deployed contracts.

Scope

• Signer/provider abstraction that does not require raw private keys by default
• Contract-aligned EIP-712 digest and calldata helpers
• AgentFactory.launchAgent submission
• SwarmFactory.createSwarm submission
• Receipt polling and event decoding

Acceptance Criteria

• SDK can prepare, sign, submit, and read back a public-agent launch on local Anvil.
• SDK can prepare, submit, and read back a swarm launch on local Anvil.
• Tests cover rejected signatures, nonce replay, bad class/toolset, and receipt decoding.
• Docs explain trust boundary and secret-handling rules.

Verification

• Local Anvil e2e with real broadcast logs.
• SDK tests pass without network secrets.

[FlowmemoryAI]

Merged incremental progress on #166: the FlowChain SDK now exports direct calldata builders for and , with tests covering calldata structure and deterministic hashes. Remaining work on this issue is signer/provider submission, receipt polling, event decoding, and local broadcast-log coverage.

[FlowmemoryAI]

Correction to the prior note: merged incremental progress on #166 now adds direct calldata builders for AgentFactory.launchAgent(...) and SwarmFactory.createSwarm(...), with tests covering calldata structure and deterministic hashes. Remaining work on this issue is signer/provider submission, receipt polling, event decoding, and local broadcast-log coverage.

[FlowmemoryAI]

Merged incremental progress for #166 in f68a672.

What changed:

• Added EIP-712 typed-data request builders for public-agent launch owner signatures.
• Added EIP-1193 provider helpers for external-wallet signing/submission without raw private keys by default.
• Added prepared transaction submission helpers for AgentFactory.launchAgent(...) and SwarmFactory.createSwarm(...).
• Added transaction receipt polling.
• Added public-agent/swarm receipt event decoding for launch, bond, fuel, swarm, and swarm-budget events.
• Exported the new SDK helper types and functions.
• Updated public docs and the gap register to narrow the remaining [Public Agent Network]: Direct contract-backed launch SDK #166 work.

Verification run:

• npm test --prefix services/flowmemory-sdk
• npm run public:test:quick
• npm run public:hardening
• node infra/scripts/check-unsafe-claims.mjs
• git diff --check

Still open for #166:

• local Anvil SDK e2e with actual provider-backed AgentFactory.launchAgent(...) submission and decoded launch/fuel/bond events;
• local Anvil SDK e2e with actual SwarmFactory.createSwarm(...) submission and decoded swarm/budget events;
• negative direct-SDK Anvil coverage for nonce replay and bad class/toolset;
• public-safe broadcast-log evidence from those Anvil runs.