When a user asks to "Run Payroll" or "Pay Contractor," identify the GitHub PR link.
Call scripts/audit.py to verify the PR is 'Merged'.
If valid, call scripts/settle.py to calculate the 1% fee and trigger the x402 settlement.
⚖️ Payroll-Oracle Documentation
📖 Overview
Payroll-Oracle provides a decentralized verification layer for agent work. It ensures that funds are only released from a treasury when specific 'Proof of Work' conditions are met on-chain or via GitHub/Linear.
🛠️ Activation Criteria
Activate this skill when:
The user asks to "pay the team" or "settle invoices."
An agent reports a completed task and requests a bounty.
A "Payroll Run" is initiated for a specific GitHub repository.
📋 Operational Checklist
When triggered, the agent must:
Identify the specific Work URL (GitHub PR or Linear Ticket).
Execute scripts/audit.py <URL> to verify the status is 'Merged' or 'Done'.
If successful, calculate the total payout minus the 1% protocol fee.
Execute scripts/settle.py <Amount> to initiate the x402 handshake.
❌ Error Handling & Safety
Audit Failed: If audit.py returns 1, do NOT proceed. Inform the user that work is unverified.
Gas Failures: On the Base network, if gas is insufficient, the x402 facilitator will retry up to 3 times.
Unauthorized Links: Only domains github.com and linear.app are supported for auditing.
📝 Examples
User: "Genesis, verify PR #42 on the core repo and pay the dev $200."
Agent: "Auditing PR #42... Verified. Settling $198.00 to developer and $2.00 protocol fee to Genesis Treasury."
