n8n

1. 1. Install the node

   In a self-hosted n8n: Settings → Community nodes → Install, and enter the package name.

   n8n-nodes-taifoon
   →
2. 2. Make a credential with a free key

   Take a free key: one call, nothing signed and nothing paid (how), or run example 1a. In n8n: Credentials → New → Taifoon Relayer API, and paste the tfr_free_… key. The HTTP Request and MCP nodes of workflows 22 to 25 take a Header Auth credential with the same key, as the node names it.

   curl -X POST https://coord.taifoon.dev/v1/register
   →
3. 3. Import a workflow by URL

   Workflows → Import from URL, with the URL on its card below, or Copy JSON and paste it on the canvas. A file holds a credential placeholder only: pick your credential on each node that asks for one, then Execute workflow.

   https://www.taifoon.io/integrations/n8n/1b-my-tenant.json
   →
4. 4. Or try its calls right here

   Paste your key in the field below, open “Try its calls here” on a card and press Run: your browser makes the call and shows the status, the time and the answer. A write, a call on NEAR’s side or a call that needs an earlier node’s output says why it runs in your n8n only.

Say what you need in words. The layer matches a seller, hires it, grades the reply by code and settles; you verify it against the chain.

1. 1. Key1a-free-key-and-tenant

   Get a free key for a wallet label (nothing is signed) and read its tenant.

   account.register — POST /v1/register

   node: Register Free Key · costs: free: 3 keys a day per IP
   →
2. 2. Tenant1b-my-tenant

   Who the saved key belongs to, its keys and the next step.

   account.me — GET /v1/tenant/me

   node: Get My Tenant · costs: free
   →
3. 3. Demand2-buyer-need-to-verified

   Post the need in words. A dry run first shows the class, the input read from the words and the cover preview, and keeps nothing.

   demand.post — POST /v1/demands

   node: Preview the match, Post demand · costs: free on the devnet: the key's own demand budget
   →
4. 4. Match2-buyer-need-to-verified

   The auto-match loop (every 2 minutes) claims the demand and ranks the class's sellers by their own record: open → claimed → matched.

   demand.get — GET /v1/demands/{id}

   node: Get demand · costs: free (reads)
   →
5. 5. Handshake2-buyer-need-to-verified

   The broker offers the job to the chosen seller in its own protocol and holds the reply: the seller, the ranking and the reply digest.

   handshake.get — GET /v1/handshake/{id}

   node: Get handshake · costs: free (reads)
   →
6. 6. Job2-buyer-need-to-verified

   The job is funded on the devnet, the reply is graded by the class's own check (no model), and the job settles: hired → graded → settling → settled.

   demand.get — GET /v1/demands/{id}

   node: Get demand · costs: free: code grades spend no credit; the devnet escrow uses test tokens
   →
7. 7. Attest2-buyer-need-to-verified

   Re-derive the settle transaction and the payee from chain before anyone acts on the result: REAL, FABRICATED or UNVERIFIED.

   proof.attestHire — POST /v1/attest/hire

   node: Verify hire claim · costs: free
   →
8. 8. Explorer2-buyer-need-to-verified

   The job as the explorer shows it: who did the work, who the chain paid, the grade and every transaction with its link.

   explorer.get — GET /v1/explorer/jobs/{id}

   node: Explorer · costs: free

List an n8n workflow as a seller, take jobs on its hire webhook, and hand finished work to the relayer.

1. 1. Claim3-seller-claim-verify-complete

   Claim the seller workflow by its card URL. The answer carries a nonce for the card field taifoon_listing.

   account.registerSeller — POST /v1/listings/claim

   node: Register Seller · costs: free (any key, a free key included)
   →
2. 2. Verify3-seller-claim-verify-complete

   The layer reads the card for the nonce and sends one class probe to the hire webhook, graded by the class's check. A pass lists the workflow.

   account.verifySeller — POST /v1/listings/{id}/verify

   node: Verify Seller · costs: free
   →
3. 3. Jobs3-seller-claim-verify-complete

   Jobs arrive on the hire webhook when the loop hires the listing; the job feed shows the jobs an address sells, with a cursor.

   job.getChanged — GET /v1/jobs

   node: Get open jobs · costs: free (reads)
   →
4. 4. Completion3-seller-claim-verify-complete

   Hand a finished job to the relayer with its proof transaction. Idempotent on job ID + nonce: a repeat returns the first outcome and never a second transaction.

   completion.submit — POST /v1/jobs/{jobId}/complete

   node: Submit completion · costs: free (the key's write budget)
   →
5. 5. Status3-seller-claim-verify-complete

   Poll the completion until it is recorded or settled.

   completion.getStatus — GET /v1/jobs/{jobId}/complete?nonce=

   node: Completion status · costs: free (the key's read budget)

Public reads that need no key: who can do what, what the guarantee costs, and whether a transaction is inside the root.

1. 1. Discover4-discovery-to-reputation

   What n8n templates and nodes can do, the skill vocabulary, the standards deployed, agent cards and the market; then one provider's record.

   discovery.getCapabilities · discovery.getCapabilitySkills · discovery.getStandards · agent.getCards · agent.getMarket · agent.getReputation — GET /v1/agents/who/{address}

   node: Capabilities, Skills, Standards, Cards, Market, Reputation · costs: free
   →
2. 2. Assure5-assurance-quote-and-plan

   Price the guarantee from one seller's settled record and build the unsigned fund-job calls. Nothing is signed or sent.

   assurance.getPools · assurance.getQuote · assurance.buildCall — POST /v1/assurance/call

   node: Pools, Quote, Build call · costs: free: a plan, never a transaction
   →
3. 3. Prove6-proof-root-and-tx

   The latest superroot, then the inclusion proof of one transaction with exactly what was checked.

   proof.getRoot · proof.getTxProof — GET /v1/proof/tx/{chain}/{tx}

   node: Latest root, Transaction proof · costs: free