| name | onchain-ledger |
| description | Logs expense and income records as immutable onchain events on Pharos mainnet or Atlantic testnet. Creates a verifiable audit trail for businesses, DAOs, freelancers, and AI agent treasuries. Use when a user or agent needs to record a financial event on Pharos, verify a past transaction, retrieve an onchain expense summary, or set an onchain budget configuration. Requires PHAROS_PRIVATE_KEY in environment for live mode; falls back to simulated mode if not set. |
| license | MIT |
| metadata | {"author":"kane_120","version":"1.0.0","part-of":"budget-oracle","pharos-mainnet-chain-id":"1672","pharos-mainnet-rpc":"https://rpc.pharos.xyz","pharos-testnet-chain-id":"688689","pharos-testnet-rpc":"https://atlantic.dplabs-internal.com"} |
| compatibility | Requires Node.js 18+ and ethers v6. Set PHAROS_NETWORK, PHAROS_PRIVATE_KEY, and BUDGET_ORACLE_CONTRACT in .env for onchain mode. Runs in simulated mode without wallet settings. |
Onchain Ledger
Use this sub-skill to create a Pharos-verifiable audit trail for expense and income records.
Commands
node skills/onchain-ledger/scripts/ledger.js log --name "Vendor payment" --amount 500000 --category Vendor --currency NGN
node skills/onchain-ledger/scripts/ledger.js reverse --hash <expenseHash> --reason "Duplicate entry"
node skills/onchain-ledger/scripts/ledger.js verify --hash <expenseHash>
node skills/onchain-ledger/scripts/ledger.js history --address <walletAddress>
Without PHAROS_PRIVATE_KEY and BUDGET_ORACLE_CONTRACT, commands return simulated JSON and never crash due to missing wallet configuration.
Supported networks:
PHAROS_NETWORK=mainnet: chain ID 1672, RPC https://rpc.pharos.xyz, explorer https://pharosscan.xyzPHAROS_NETWORK=testnet: chain ID 688689, RPC https://atlantic.dplabs-internal.com, explorer https://atlantic.pharosscan.xyz
