Getting started

1. Environment

Node.js 20 or 22 LTS and npm. Clone and install from the lockfile:

2. Compile and test

3. Local deployment

Both scripts print a JSON manifest with addresses and the registered hook order. Ignition alternative: npx hardhat ignition deploy ignition/modules/ARexToken.js --network localhost.

4. First batch: the walkthrough script

It deploys the stack and runs one lot through creation, transfer, sanction, split, processing, attestation, freeze, forced transfer, retirement and burn, printing the rejection code before each blocked step. Change the numbers and re-run; it is the fastest way to understand the pipeline.

For manual poking, open a console against the node: npx hardhat console --network localhost, then const t = await ethers.getContractAt("ARexToken", "<address printed by the deploy script>").

See the Implementation Guide chapter of the whitepaper (whitepaper/ui/content/11-implementation-guide.md) for createBatch, transfers with transferCheck, transform, attestations and enforcement, with runnable snippets.

5. Read before extending

• Documentation map
• System Design Document
• Hook development
• Testing
• Audit readiness