johba/harb

johba b276392e7a chore: gardener housekeeping 2026-03-23

- Update all AGENTS.md watermarks to HEAD (224edcc)
- onchain/AGENTS.md: document VWAPTracker _hasRecenterTick guard (#609),
  overflow guard for slots 0-7 (#997), Floor Ratchet defeated (#1067),
  fee-income delta_bps audit trail (#1084)
- landing/AGENTS.md: document SecurityInfo.vue component (#147)

Issues actioned via API:
- Unblocked #1099, #1100, #1101 (all prereqs 1031/997/1067/1054 closed)
- Created #1134 bundled backlog: onchain source quality cleanup (4 dust items)
- Closed dust #601, #627, #739, #741 → bundled into #1134

2026-03-23 07:04:19 +00:00

2 KiB

Raw Blame History

Transaction Bot - Agent Guide

Automation service that maintains liquidity alignment and tax enforcement for the KRAIKEN protocol.

Responsibilities

Monitor Ponder GraphQL metrics to detect when recenter() should be triggered.
Track staking positions for overdue taxes and call payTax() when profitable.
Expose a status endpoint (GET /status) for operational visibility.

Architecture

service.js - Main loop that polls the GraphQL endpoint, evaluates triggers, and submits transactions.
generateKey.js - Utility for provisioning dedicated bot wallets.
package.json scripts - npm install, npm start, and debug runs via DEBUG=* npm start.
ES Module: This service uses "type": "module" and imports kraiken-lib as an ES module. All imports use ES module syntax (import instead of require()).
Node.js Compatibility: Requires Node.js ≥14 with ES module support. The __dirname and __filename globals are not available; use import.meta.url with fileURLToPath() instead.

Configuration

Set the following environment variables (automatically generated when the stack script is used):

ENVIRONMENT=BASE_SEPOLIA_LOCAL_FORK|BASE_MAINNET_LOCAL_FORK|BASE_SEPOLIA|BASE
PROVIDER_URL=<rpc-url>
PRIVATE_KEY=<hex-private-key>
LM_CONTRACT_ADDRESS=<liquidity-manager-address>
STAKE_CONTRACT_ADDRESS=<stake-contract-address>
GRAPHQL_ENDPOINT=<ponder-graphql-url>
# Optional: PORT=43069

Operations

Launch via nohup ./scripts/dev.sh start &; the script handles env injection and process supervision.
For focused debugging, run npm install then npm start within services/txnBot/ after the stack is already up.
Monitor logs for transaction receipts and ensure gas pricing stays within acceptable bounds.

Safety Checklist

Use dedicated wallets and keep balances minimal.
Rotate keys if compromise is suspected; update secrets before restarting the stack.
Observe exponential backoff behaviour and avoid hammering RPC endpoints on failure.

2 KiB Raw Blame History