@persistent-ai/fireflow-overcast (0.35.2)
Installation
@persistent-ai:registry=npm install @persistent-ai/fireflow-overcast@0.35.2"@persistent-ai/fireflow-overcast": "0.35.2"About this package
@persistent-ai/fireflow-overcast
FireFlow nodes for Overcast — private stablecoin payments on the Aztec blockchain.
This package is licensed under Apache 2.0. A public snapshot lives at Galactica-corp/fireflow-overcast.
Overview
This package provides atomic FireFlow graph nodes that let an AI agent execute private stablecoin payments using the Overcast protocol on Aztec. Each node is a single operation with defined inputs and outputs, composable into larger payment flows.
See docs/specification.md for the full node roadmap.
Two packages
This one holds what every FireFlow process needs to deserialise, draw and edit a flow with Overcast
nodes in it: the node classes, their port schemas, the shared types, the runtime contract
(src/shared/runtime.ts) and the account-pointer helpers. Its JavaScript imports nothing from
@aztec/*; the live-object types it names are import type, erased by the compiler, and the nodes
never read a field of them. The published .d.ts files do name those types, from packages this
manifest lists only as devDependencies: a consumer that type-checks this package's declarations with
skipLibCheck: false needs @aztec/aztec.js, @aztec/stdlib, @aztec/wallets and
@galactica-net/x402-mechanism installed for that; FireFlow's own configs skip library checks, and
no process reads these types at runtime.
The runtime the nodes call at execute time — wallets, PXE, transactions, artifact repair, x402 — is
@persistent-ai/fireflow-overcast-aztec, which is bundled into the
execution worker's aztec entry and nowhere else. The Aztec version pin and its consequences are
documented there. A process that never loads it can still open an Overcast flow; executing one there
fails with a sentence naming the entry to run (src/nodes/runtime-registry.ts).
Nodes (current iteration)
| Node | Description |
|---|---|
| Aztec Ensure Account | Get-or-create the caller's aztec-account vault secret and .ffsecret pointer; output AztecAccountRef |
| Aztec Account Signer | Assemble an AztecSignerRef from an AztecAccountRef (no vault / PXE I/O) |
| Parse Contract Artifact | Validate a VFS artifact JSON file and emit an AztecArtifactRef |
| Aztec Smart Contract | Bind a deployed contract address to an AztecArtifactRef |
| Get Fee Payer | Assemble an AztecFeePayerRef (fee juice or sponsored FPC) |
| Aztec Transaction Builder | Assemble an AztecTxRequestRef for simulation or submission |
| Simulate Transaction | Resolve the request and locally simulate (read methods) |
| Submit Aztec Transaction | Resolve the request and submit to the network |
Agent wallet onboarding
Aztec Ensure Account get-or-creates the end user's Aztec credentials during a conversation: found-branch when the pointer already exists, mint when it does not. Output is a public AztecAccountRef — no secret ports. Aztec Account Signer takes that ref and assembles an AztecSignerRef; Simulate / Submit / x402 rehydrate the live wallet via resolveSigner. See docs/specification.md §5.1 and §5.1.1.
Environment
| Variable | Default | Description |
|---|---|---|
AZTEC_NODE_URL |
http://localhost:8080 |
Aztec node RPC endpoint |
Development
pnpm --filter @persistent-ai/fireflow-overcast build
pnpm --filter @persistent-ai/fireflow-overcast test
pnpm --filter @persistent-ai/fireflow-overcast typecheck
The integration suite, the testnet measurement and the local fixture deploy moved with the runtime:
see fireflow-overcast-aztec.
Exports
@persistent-ai/fireflow-overcast— shared types, port schemas, the runtime contract, account-pointer helpers@persistent-ai/fireflow-overcast/nodes— the node classes; importing registers them (fireflow-trpc/server)@persistent-ai/fireflow-overcast/testing— the vault harness the account tests and the runtime's resolver test share
License
Apache License 2.0 — see LICENSE. Copyright 2026 PersistentAI.
Dependencies
Dependencies
| ID | Version |
|---|---|
| @persistent-ai/fireflow-types | 0.35.2 |
Development Dependencies
| ID | Version |
|---|---|
| @aztec/aztec.js | 5.0.1 |
| @aztec/stdlib | 5.0.1 |
| @aztec/wallets | 5.0.1 |
| @galactica-net/x402-mechanism | ^1.1.2 |
| @persistent-ai/typescript-config | 0.35.2 |
| @types/node | ^26.6.2 |
| vitest | ^5.0.1 |