veilify_getWithdrawalPolicy

{ "jsonrpc": "2.0", "id": 1, "method": "veilify_getWithdrawalPolicy", "params": [] }

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "grids": [
      { "token": "0x0000000000000000000000000000000000000000", "decimals": 18,
        "amounts": ["100000000000000000", "500000000000000000", "1000000000000000000"] },
      { "token": "<USD stablecoin address>", "decimals": 6,
        "amounts": ["250000000", "500000000", "1000000000", "3000000000"] }
    ],
    "allowCustomAmounts": true,
    "withdrawalFeeBps": 50,
    "feeRateSource": "contract",
    "rounds": {
      "intervalMinutes": 15, "offsetMinutes": 0,
      "snapshotDelayMinutes": 5, "cutoffMinutes": 2,
      "enabled": true, "maxLegs": 5, "maxScheduleHours": 24,
      "gasAbsorbPct": 0, "snapshotPriceMargin": 1.5,
      "nextRounds": [1791206100, 1791207000, 1791207900]
    },
    "roundGas": {
      "maxFeePerGas": "0x3b9aca00", "maxPriorityFeePerGas": "0x5f5e100",
      "gasLimit": "0x5265c0", "capFeePerGas": "0xb2d05e00", "minFeePerGas": "0xbebc200",
      "baseFeeMultiplier": 2, "baseFeePerGas": "0x1593b914",
      "reservePerLeg": "0x132f4579c98000", "priceAboveCap": false
    },
    "serverTime": 1791205179,
    "source": "live"
  }
}

The veilify_* methods and Round fields describe the proposed Veilify interface. No live Veilify RPC deployment is published yet.

Returns the live withdrawal policy. Public. No params.

Result

'live' | 'cache' | 'default'

Where the policy came from.

number

Unix seconds. Clients compute a clock offset from it.

number

Current withdrawal fee in basis points.

string

contract when read from the pool.

boolean

Grid[]

Show Grid

address

0x000…0 for ETH.

number

string[]

Ascending, unique, base units.

Rounds

Show Rounds

boolean

number

1–1440

number

Less than the interval.

number

snapshotDelay + cutoff must be less than the interval, or rounds are treated as disabled.

number

1–3

number[]

Upcoming round timestamps (Unix seconds).

RoundGas

Show RoundGas

hex

number

hex

Native reserve per Round leg. Falls back to gasLimit × maxFeePerGas.

boolean

When true, Round mode is unavailable.

Client rules

Round mode is enabled only when the policy came from the RPC, rounds.enabled is true, and priceAboveCap is false.
Source precedence: Veilify RPC → gatekeeper /v1/public-config → built-in defaults. Built-in defaults always have rounds disabled.

{ "jsonrpc": "2.0", "id": 1, "method": "veilify_getWithdrawalPolicy", "params": [] }

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "grids": [
      { "token": "0x0000000000000000000000000000000000000000", "decimals": 18,
        "amounts": ["100000000000000000", "500000000000000000", "1000000000000000000"] },
      { "token": "<USD stablecoin address>", "decimals": 6,
        "amounts": ["250000000", "500000000", "1000000000", "3000000000"] }
    ],
    "allowCustomAmounts": true,
    "withdrawalFeeBps": 50,
    "feeRateSource": "contract",
    "rounds": {
      "intervalMinutes": 15, "offsetMinutes": 0,
      "snapshotDelayMinutes": 5, "cutoffMinutes": 2,
      "enabled": true, "maxLegs": 5, "maxScheduleHours": 24,
      "gasAbsorbPct": 0, "snapshotPriceMargin": 1.5,
      "nextRounds": [1791206100, 1791207000, 1791207900]
    },
    "roundGas": {
      "maxFeePerGas": "0x3b9aca00", "maxPriorityFeePerGas": "0x5f5e100",
      "gasLimit": "0x5265c0", "capFeePerGas": "0xb2d05e00", "minFeePerGas": "0xbebc200",
      "baseFeeMultiplier": 2, "baseFeePerGas": "0x1593b914",
      "reservePerLeg": "0x132f4579c98000", "priceAboveCap": false
    },
    "serverTime": 1791205179,
    "source": "live"
  }
}

{ "jsonrpc": "2.0", "id": 1, "method": "veilify_getWithdrawalPolicy", "params": [] }

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "grids": [
      { "token": "0x0000000000000000000000000000000000000000", "decimals": 18,
        "amounts": ["100000000000000000", "500000000000000000", "1000000000000000000"] },
      { "token": "<USD stablecoin address>", "decimals": 6,
        "amounts": ["250000000", "500000000", "1000000000", "3000000000"] }
    ],
    "allowCustomAmounts": true,
    "withdrawalFeeBps": 50,
    "feeRateSource": "contract",
    "rounds": {
      "intervalMinutes": 15, "offsetMinutes": 0,
      "snapshotDelayMinutes": 5, "cutoffMinutes": 2,
      "enabled": true, "maxLegs": 5, "maxScheduleHours": 24,
      "gasAbsorbPct": 0, "snapshotPriceMargin": 1.5,
      "nextRounds": [1791206100, 1791207000, 1791207900]
    },
    "roundGas": {
      "maxFeePerGas": "0x3b9aca00", "maxPriorityFeePerGas": "0x5f5e100",
      "gasLimit": "0x5265c0", "capFeePerGas": "0xb2d05e00", "minFeePerGas": "0xbebc200",
      "baseFeeMultiplier": 2, "baseFeePerGas": "0x1593b914",
      "reservePerLeg": "0x132f4579c98000", "priceAboveCap": false
    },
    "serverTime": 1791205179,
    "source": "live"
  }
}

RPC API Reference

Veilify Methods

veilify_getWithdrawalPolicy

Result

Client rules

​Result

​Client rules

Result

Client rules