@zanii/fta

FTA (Federal Tax Authority) filing evidence for Meezan & Books. The wall: the agent prepares filings but never files or advises — filing is a licensed Tax-Agent activity. This records each step as a receipt and makes the boundary itself evidence: the Tax-Agent handoff is its own signed receipt, so the chain shows prepared → handed to the licensed agent and proves nothing crossed the wall.

npm install @zanii/fta

Usage

import { buildFilingPrepReceipt, buildTaxAgentHandoff, FTA_WALL } from '@zanii/fta';

// 1. prepared (never filed):
const prep = buildFilingPrepReceipt({ filingType: 'VAT-return', period: '2026-Q2', preparedBy: agentDid, manifestHash });
await agent.record(prep);

// 2. the handoff to a LICENSED Tax Agent — the wall boundary, receipted:
const handoff = buildTaxAgentHandoff({ filingType: 'VAT-return', period: '2026-Q2', fromAgent: agentDid, toTaxAgent: 'TAN-12345' });
await agent.record(handoff);

FTA_WALL is the preset your delegation enforces — it grants fta.prepare.* / fta.read.* and never fta.file.* / fta.advise.*. verifyFilingEvidence(payload) validates a receipt.

Changelog

• 0.1.0 — initial release: buildFilingPrepReceipt, buildTaxAgentHandoff, verifyFilingEvidence, FTA_WALL.

License

Apache-2.0.