Wallet-aware Raven Atlas transfer tooling for safe NGN payouts.
This repository packages:
- a transfer command script:
scripts/raven-transfer.mjs - skill metadata/config for agent runtimes:
SKILL.md,agents/openai.yaml - operational references:
references/*.md - tests:
tests/*.test.mjs
The script supports:
- wallet balance checks (
--cmd=balance) - bank discovery (
--cmd=banks) - account lookup (
--cmd=lookup) - transfer status checks, including reversal detection (
--cmd=transfer-status) - confirmation-gated transfers (
--cmd=transfer) - merchant settlement transfers (
--cmd=transfer-merchant)
All command outputs are JSON with a success/failure envelope.
- Node.js 18+
- One auth source in your environment:
RAVEN_API_KEY_FILE(preferred, points to achmod 600orchmod 400file)RAVEN_API_KEY
Optional environment variables:
RAVEN_API_BASE(default:https://integrations.getravenbank.com/v1)RAVEN_TIMEOUT_MS(default:30000)RAVEN_READ_RETRIES(default:2)RAVEN_RETRY_DELAY_MS(default:300)RAVEN_DISABLE_LOCAL_STATE=1(disable on-disk idempotency state)
mkdir -p "$HOME/.config/raven"
printf '%s\n' "your_raven_api_key_here" > "$HOME/.config/raven/raven_api_key"
chmod 600 "$HOME/.config/raven/raven_api_key"
export RAVEN_API_KEY_FILE="$HOME/.config/raven/raven_api_key"
node ./scripts/raven-transfer.mjs --help
node ./scripts/raven-transfer.mjs --cmd=balanceFallback (direct env injection):
export RAVEN_API_KEY="your_raven_api_key_here"- Check funds:
node ./scripts/raven-transfer.mjs --cmd=balance - Resolve beneficiary account:
node ./scripts/raven-transfer.mjs --cmd=lookup --account_number=<number> --bank_code=<code> - Preview transfer without
--confirmto getconfirmation_token. - Execute exactly once using
--confirm="CONFIRM TXN_...". - Re-check settlement:
node ./scripts/raven-transfer.mjs --cmd=transfer-status --trx_ref=<trx_ref>
node ./scripts/validate-skill-package.mjs
node --test ./tests/unit-normalizers.test.mjs
node --test ./tests/contract-live.test.mjsLive tests are gated and skipped unless required env vars are set.