The P2Flux protocol layer: the Solidity contracts, their ABIs, and the TypeScript definitions that describe them — EIP-712 structures, public chain constants and the amount codec.
This repository is the canonical source for all of it. P2Flux/core consumes it as a pinned
dependency; a protocol change happens here, gets a tag, and core bumps the pin.
| contract | what it does |
|---|---|
P2FluxSplitter |
one-time payments: settles a payment in a single transaction, splitting the fee from the merchant's share. Holds no balance between calls; no withdrawals, no custody, no upgrade path. |
P2FluxRecurring |
recurring payments: charges a customer-signed EIP-712 authorization once per period, reimbursing the relayer's measured gas cost. Not upgradeable, not proxied, no delegatecall. |
P2FluxSponsoredSplitter |
one-time payments for a buyer with USDC and no ETH: the buyer signs, the relayer sends, and the buyer pays the network fee in USDC. |
P2FluxGasSponsor |
lets a customer with no ETH start a subscription, restore an allowance or remove it, by signing. Collects the quoted network fee in the same transaction. |
P2FluxX402Splitter |
AI agent payments (x402 exact and upto): pays into a per-seller vault, which pays the seller and the 1% fee. |
P2FluxBatchVaults |
prepaid agent payments (x402 batch-settlement): per-seller vaults that pay the seller 97% and P2Flux 3%. |
P2FluxGasRefill |
keeps the relayer in gas: swaps USDC from the gas treasury to ETH on Uniswap when the relayer runs low. |
None is upgradeable or proxied. Two things can change after deployment:
P2FluxRecurring.relayer, rotatable by the immutableadminso a compromised hot key can be replaced without redeploying.P2FluxGasRefill's limits -dailyCapUsdc,maxTargetWeiandmaxSlippageBps(never above 5%) - throughsetLimits, callable only by the immutabletreasurywhose USDC it spends.
Everything else is fixed at deployment.
import { recurringAbi, recurringTypedData, RECURRING_FEE_BPS } from '@p2flux/contracts/recurring'
import { splitterAbi, paymentIdFor } from '@p2flux/contracts/splitter'
import { BASE_SEPOLIA, usdc, formatUsdc } from '@p2flux/contracts/addresses'
import { erc20Abi } from '@p2flux/contracts/abi'
import { sponsoredSplitterAbi, gasSponsorAbi } from '@p2flux/contracts/sponsored'
import { p2fluxX402SplitterAbi, p2fluxBatchVaultsAbi, x402VaultAddress } from '@p2flux/contracts/x402'Raw ABIs, if you would rather not take the package: abi/P2FluxRecurring.json,
abi/P2FluxSplitter.json, abi/P2FluxSponsoredSplitter.json, abi/P2FluxGasSponsor.json,
abi/P2FluxX402Splitter.json (also as @p2flux/contracts/artifacts/<name>.json).
P2FluxBatchVaults has no JSON file; its ABI is p2fluxBatchVaultsAbi in @p2flux/contracts/x402.
P2FluxGasRefill has no published ABI; npm run compile writes it to out/.
They are build output of the .sol files here — npm run abi:check
fails if they have drifted from a fresh compile.
The TypeScript ABIs in src/ are hand-written subsets rather than the full compiled artifact, kept
honest by the tests in test/: recurring.test.ts pins every EIP-712 hash and economic constant
against the deployed bytecode, so a mirror that disagrees with the contract fails the suite.
npm install
npm run compile # solc 0.8.26 -> out/
npm test # compiles, then runs the suite against anvil
npm run abi:check # committed ABIs match a fresh compile
npm run build # TypeScript -> dist/npm test needs Foundry's anvil on your PATH. It is used purely
as a local EVM to test against — the build system is solc via npm, so there is no Foundry or Hardhat
project to configure.
dist/ is committed on release tags so consumers can install straight from a git tag without
running install scripts. It is build output; edit src/.
Constants for both networks live in src/addresses.ts.
Base Mainnet (chainId 8453) — live:
| Contract | Address | Verified |
|---|---|---|
| P2FluxSplitter | 0x5A3bD0945cd0C80B124870881dE49a717D20E0D0 |
Sourcify exact_match · BaseScan |
| P2FluxRecurring | 0xb415A9910Ef627e3bEF10F5Cb9DC92a3271e0975 |
Sourcify exact_match · BaseScan |
| P2FluxSponsoredSplitter | 0x95E18ec05D4282acB3aab7aD60325bA4EEeEa8df |
deployed 2026-09-06 from manifest 827b76fa…b2034 (block 50966621) · BaseScan · Sourcify |
| P2FluxGasSponsor | 0xD1DDAaa301403d18fD4A23Fc69493ef48af90285 |
deployed 2026-09-06 from the same manifest (block 50966742) · BaseScan · Sourcify |
| P2FluxX402Splitter | 0x9A11CE97eaE8674a70487b1D18C06b1C7f654Ec1 |
AI agent payments (x402); deployed 2026-10-01 from manifest 4065edac…8232 (block 52031062) · BaseScan · Sourcify |
| P2FluxBatchVaults | 0xa62eDD9B45a0564a63C248564335BA7B2E3877A4 |
prepaid agent payments; 2026-10-01, manifest b4aa7509…9c67 (block 52031076) · BaseScan · Sourcify |
| P2FluxGasRefill | 0x78cb470600EA0D68cE846bfc3bB455786BF56537 |
relayer gas from the gas treasury; 2026-10-01, manifest 48bebefb…2adc (block 52031084) · BaseScan · Sourcify |
| USDC (Circle, native) | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 |
canonical |
The sponsored pair lets a buyer holding USDC and no ETH pay, start a subscription, or repair or remove
an allowance by signing: the buyer pays the network fee in USDC, the P2Flux relayer pays the Base gas.
Both contracts are relayer-only and immutable; P2FluxSponsoredSplitter charges the same 1% and the
merchant-funded 0.10 USDC fixed network fee as the native path, with a 0.25 USDC hard cap on any
single sponsored fee. Sepolia: 0x876f7b98e8c06291ec916a3223a92038b0a8774f / 0x2dc51643040d7c396f1199a0664ac095d4b89ec5.
Base Sepolia (chainId 84532) — test:
| Contract | Address |
|---|---|
| P2FluxX402Splitter (v2) | 0x12Ae2c266014EB2A181024D12be9C4e5F468f7c8 |
| P2FluxBatchVaults | 0x08EbEb85c53895F752bdAc9C115aF33FCff04F3E |
| USDC (Circle) | 0x036CbD53842c5426634e7929541eC2318f3dCF7e |
Base Sepolia remains the test deployment. Deployment tooling that signs with a live key is deliberately not here — it belongs with the operator, in the private infrastructure.
MIT.