USDCx Payout Engine - Smart Contracts

Batch payout contracts for Stacks testnet. The core contract (batch-payout.clar) performs multiple SIP-010 transfers in a single transaction and emits event logs for receipt parsing.

Contract: batch-payout.clar

Purpose

Execute batch SIP-010 token transfers and emit transfer events that the relayer can parse for payroll receipts.

Functions

Function	Purpose
batch-transfer	Transfer tokens to up to 50 recipients in one tx
set-admin	Update admin principal
get-admin	Read current admin

Behavior

• Uses a SIP-010 token trait contract for transfer
• Transfers are signed by the caller (tx-sender), no custody
• Emits print logs for each transfer with recipient, amount, memo, ok

Deployments

Deployment plans live in deployments/:

• default.devnet-plan.yaml
• default.simnet-plan.yaml
• default.testnet-plan.yaml

Running Devnet

# From repo root
pnpm devnet

# Or directly
cd contracts/usdcx-payout-engine
clarinet devnet start

Testing

cd contracts/usdcx-payout-engine
pnpm i
pnpm test

Notes

• mock-token.clar is for local testing only.
• Batch size is limited to 50 entries per transaction.