EVM contract

Two contracts share the EVM side. ApsisInventory is the vault: it holds all float, receives plain deposits, and is the only contract that pays value out. ApsisRouter carries every entry point that swaps or takes a signature — aggregator deposits, permit and permit2 variants, gasless witness deposits, same-chain swaps, partner funding — and forwards the resulting funds into the inventory. The router is UUPS-upgradeable by the owner; the inventory is not upgradeable.

Chain	Inventory (vault)	Router
`arbitrum`

Solana is covered separately in SVM program. Prefer the router_address from the quote over these constants. A plain cross-chain deposit binds to the inventory, a swap deposit is sent to the router returned by GetSwapInstructions, and a same-chain swap binds to the router.

Inventory deposit entry points

function depositNative(bytes32 quoteHash) external payable;

function depositToken(bytes32 quoteHash, address token, uint256 amount) external;

Both emit Deposit and leave the funds in the vault.

Router deposit entry points

function depositTokenWithPermit(
    bytes32 quoteHash,
    address token,
    uint256 amount,
    uint256 deadline,
    uint8 v,
    bytes32 r,
    bytes32 s
) external;

function depositTokenWithPermit2(
    bytes32 quoteHash,
    address token,
    uint256 amount,
    uint256 nonce,
    uint256 deadline,
    bytes calldata signature
) external;

function depositWithSwap(
    bytes32 quoteHash,
    address srcToken,
    uint256 amountIn,
    address aggregator,
    bytes calldata swapData,
    address bridgeToken,
    uint256 minBridgeOut
) external payable;

depositWithSwapAndPermit and depositWithSwapAndPermit2 take the same arguments plus the respective signature parameters. Permit variants attempt the permit and ignore its failure, so an already-consumed permit does not revert the deposit. Token pulls credit what was actually received, so fee-on-transfer amounts are accounted at the vault, not assumed. Two witness variants back gasless orders: depositTokenWithPermit2Witness and depositWithSwapAndPermit2Witness take an owner plus a permit2 SignatureTransfer witness signature binding the quote hash (and, for swaps, the bridge token and floor), so an operator wallet can submit the deposit on the signer’s behalf. They are called by the operator’s relayer, not by integrators.

Same-chain swap

function swapAndForward(
    bytes32 quoteHash,
    address srcToken,
    uint256 amountIn,
    address aggregator,
    bytes calldata swapData,
    address dstToken,
    uint256 minAmountOut,
    uint256 amountOut,
    uint16 referrerBps,
    address recipient
) external payable;

Swaps and pays the recipient in one transaction, on the router. Delivery is floored at minAmountOut and capped at amountOut; the referrer share and any surplus are forwarded to the vault. swapAndForwardWithPermit and swapAndForwardWithPermit2 add the signature parameters. See Same-chain swaps.

Partner funding

function fundPartner(bytes32 fundingId, address token, uint256 amount) external payable;

Deposits an allowlisted funding token against a funding id issued by BuildPartnerFunding, emitting PartnerFunding. The indexer credits the partner’s balance from the event. See PartnerApi funding.

Voucher redemption

function redeemVoucher(
    bytes32 id,
    address token,
    address referrer,
    uint256 amount,
    bytes calldata signature
) external;

On the inventory, callable by anyone. The EIP-712 signature is verified against the current voucher-signer set, the id is marked used so it cannot be redeemed twice, and the amount is paid to referrer from the vault. See Referral program.

Operator functions

Restricted to the owner or registered executors, listed for completeness.

Function	Contract	Caller
`fulfillToken`, `payToken`	Inventory	Executors. Pay out fulfillments and refunds.
`fulfillWithSwap`	Router	Executors. Fulfillments that swap into the destination token.
`setExecutor`, `setVoucherSigner`, `revokeVoucherSigners`	Inventory	Owner.
`setAggregator`, `setFundingToken`	Router	Owner. Allowlist management.
`withdraw`	Both	Owner. Moves float out.
`pause`, `unpause`	Both	Owner. Halts deposits.
`transferOwnership`, `acceptOwnership`	Inventory	Owner, two-step.

Events

Event	Emitted by
`Deposit(bytes32 quoteHash, address token, uint256 amount, address from)`	Inventory: `depositToken`, `depositNative`, and router deposits forwarding in
`DepositWithSwap(bytes32 quoteHash, address from, address srcToken, uint256 amountIn)`	Router swap deposits
`SameChainSwap(...)`	Router: `swapAndForward`
`Fulfilled(...)`	Inventory `fulfillToken`, router `fulfillWithSwap`
`PartnerFunding(bytes32 fundingId, address token, uint256 amount, address from)`	Router: `fundPartner`
`VoucherRedeemed(bytes32 id, address token, address referrer, uint256 amount)`	Inventory: `redeemVoucher`
`AggregatorSet`, `FundingTokenSet`	Router allowlist changes
`ExecutorSet`, `VoucherSignerSet`, `VoucherSignersRevoked`	Inventory allowlist changes
`Paused`, `Unpaused`, `OwnershipTransferStarted`, `OwnershipTransferred`	Ownership and pause

The indexer matches Deposit and SameChainSwap against stored quotes by quoteHash.

Reverts

Error	Cause
`InsufficientOutput`	A swap or fulfillment delivered less than the committed minimum.
`AggregatorNotAllowed`	The aggregator is not allowlisted. Refetch swap instructions.
`SwapFailed`	The aggregator call failed, usually stale calldata.
`InvalidMsgValue`	Transaction value does not match the call.
`InvalidReferrerBps`	`referrerBps` above the contract cap.
`FundingTokenNotAllowed`	`fundPartner` with a token outside the allowlist.
`GasDropNotAllowed`	Gas drop requested where it is not permitted.
`EnforcedPause`	The contract is paused.
`VoucherUsed`	Voucher id already redeemed.
`InvalidVoucherSignature`	Signature does not match a registered signer.
`Unauthorized`, `NotOwner`	Caller is not an executor or the owner.
`TransferFailed`, `ApproveFailed`, `NativeForwardFailed`	Underlying token or native transfer failed.

Reference

Blockchain

EVM contract

Inventory deposit entry points

Router deposit entry points

Same-chain swap

Partner funding

Voucher redemption

Operator functions

Events

Reverts

​Inventory deposit entry points

​Router deposit entry points

​Same-chain swap

​Partner funding

​Voucher redemption

​Operator functions

​Events

​Reverts

Inventory deposit entry points

Router deposit entry points

Same-chain swap

Partner funding

Voucher redemption

Operator functions

Events

Reverts