Docs Reference
JSON-RPC
Every method of the Acrux Net gateway, its params, its result, the errors it returns, and every type those carry.
The Acrux Net gateway answers JSON-RPC 2.0 over HTTP POST, at / or /rpc. It serves the net's slots, windows, schedule, transactions, balances and the demo pool, and it takes transactions and fragments for a target slot. The same data streams live over the event stream.
| Local | |
|---|---|
| JSON-RPC | http://127.0.0.1:4930 |
| Health | GET http://127.0.0.1:4930/health |
Request and response
curl -s http://127.0.0.1:4930 \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"getCurrentWindow","params":{}}'import { createGatewayClient } from '@acrux/contract'
const net = createGatewayClient({ rpcUrl: 'http://127.0.0.1:4930', wsUrl: 'ws://127.0.0.1:4931' })
const window = await net.call('getCurrentWindow', {})A request is { "jsonrpc": "2.0", "id", "method", "params" }. id is a string or a non-negative integer and comes back unchanged. params is always an object; a method without params takes {}. Unknown keys in params are refused.
A success is { "jsonrpc": "2.0", "id", "result" }. A failure is { "jsonrpc": "2.0", "id", "error": { "code", "message", "data" } }, where data is the error envelope every Acrux service returns; branch on data.error.code.
error.code | When | data.error.code |
|---|---|---|
| -32700 | the body is not JSON | INVALID_INPUT |
| -32600 | not a JSON-RPC 2.0 request with an id | INVALID_INPUT |
| -32601 | unknown method | NOT_FOUND |
| -32602 | params fail validation; data.error.fieldErrors names each field | INVALID_INPUT |
| -32000 | the method ran and refused; error.message repeats the code | any ErrorCode |
Numbers that can exceed 2^53 (lamports, stake, priority fees) are decimal strings. Times are integers in microseconds, each measured from the anchor its field names. Proposer and track indices start at 1; slice, fragment and merged-order indices start at 0. A null entry in an attestation vector pi is the paper's ⊥, a late proposer.
Methods
| Method | Returns |
|---|---|
getSnapshot | the whole current view of the net |
getSlot | one slot, complete |
getRecentSlots | the last slots, up to 64 |
getCurrentWindow | the window producing now |
getSchedule | the windows ahead |
getCounters | net-wide counters |
getTransaction | one transaction's trail |
getBalance | an address's balance and reserve |
getDemoPool | the demo pool's mints and reserves |
getQuote | a swap quote on the demo pool |
getLatestBlockhash | the blockhash to sign a transaction against |
getExecutionSnapshot | the executed state of the latest finalized cblock |
getSlotBlocks | a slot's agreed blocks, encrypted, with its attestations |
submitTransaction | takes a plain transaction for its target slot |
submitFragment | takes one fragment of a t-of-n transaction |
getLabReplay | a Fault Lab run's recorded events |
getSnapshot
Everything a new view of the net needs at once: the stream position, status, current window, the last 64 slots, the windows ahead, the counters and the parameters. The event stream sends the same object as its first message.
Params: an empty object, {}.
Result: NetSnapshot.
getSlot
One slot with everything known about it: its window, each proposer's block and commitment, every attestation, the agreed set, the merged order, the four-track schedule, the state hash and its cblock.
| Param | Type | Required | Meaning |
|---|---|---|---|
slot | integer | yes | the slot number |
Result: Slot.
Errors: NOT_FOUND for a slot the gateway does not hold.
getRecentSlots
The most recent slots, oldest first, including the ones still in progress, each in the shape getSlot returns. /net pauses and steps through these.
| Param | Type | Required | Meaning |
|---|---|---|---|
limit | integer, 1 to 64, default 64 | no | how many slots, newest last |
Result: Slot[].
getCurrentWindow
The window producing now: its hub, slot range, consensus slots and three proposers.
Params: an empty object, {}.
Result: Window.
getSchedule
The windows after the current one, in order, with the hub and proposers each will have.
| Param | Type | Required | Meaning |
|---|---|---|---|
limit | integer, 1 to 64, default 8 | no | how many windows ahead |
Result: Window[].
getCounters
Params: an empty object, {}.
Result: Counters.
getTransaction
A transaction's trail by its ID: header, receivers, each fragment's inclusion, the slot where it became readable and executed, its position in the merged order, result, logs and finalization. An ID the gateway has never seen returns state unknown.
| Param | Type | Required | Meaning |
|---|---|---|---|
id | hash | yes | the transaction ID |
Result: Transaction.
getBalance
An address's lamports, the part held as the 0.001 SOL fee-payer reserve, and what is spendable above it.
| Param | Type | Required | Meaning |
|---|---|---|---|
address | address | yes | the Acrux Net address |
Result: Balance.
getDemoPool
Acrux Net's demo constant-product pool: its two demo mints, reserves and fee.
Params: an empty object, {}.
Result: DemoPool.
getQuote
A quote for swapping amountIn of inputMint on the demo pool. The output is computed with integer arithmetic on the current reserves after the pool fee; minimumOut applies slippageBps.
| Param | Type | Required | Meaning |
|---|---|---|---|
inputMint | address | yes | the demo mint you pay in |
amountIn | u64 string | yes | amount in, in the mint's base units; more than 0 |
slippageBps | integer, 0 to 10000 | yes | tolerance for minimumOut, basis points |
Result: Quote.
Errors: INVALID_INPUT when inputMint is not one of the pool's mints.
getLatestBlockhash
A blockhash to sign a transaction against: the one from 8 slots before the latest executed slot, so every validator holds it. A transaction may carry any blockhash of the last 1,200 slots, one minute.
Params: an empty object, {}.
Result:
| Field | Type | Required | Meaning |
|---|---|---|---|
blockhash | address | yes | a blockhash from 8 slots before slot, for a transaction's recentBlockhash |
slot | integer | yes | the latest executed slot |
startedSlot | integer | yes | the latest started slot; a send targets a slot after it |
getExecutionSnapshot
The executed state of the latest finalized cblock, for a follower to start from: what acrux node follow loads into its own SVM. Params: an empty object, {}.
| Field | Meaning |
|---|---|
consensusSlot | the finalized cblock's consensus slot |
lastSlot | its last slot, 4 × consensusSlot + 3 |
executor | the executed state: every account, the executed transaction IDs, the recent blockhashes, the per-window inclusion charges, the fee totals, the track capacity and the state hash |
threshold | the fragments held toward threshold transactions not yet rebuilt |
Errors: NET_UNAVAILABLE before any cblock is finalized.
getSlotBlocks
One slot's agreed blocks as their proposers sent them, encrypted, with the slot's attestations and their released keys. Params: { "slot": n }.
| Field | Meaning |
|---|---|
slot | the slot |
agreed | the agreed set P |
blocks[].proposer | the block's proposer index |
blocks[].slices[] | each slice: meta, its ShredMeta; cipher, the slice's ciphertext in base64; root, its Merkle root in hex |
attestations[] | each attestation: proposer, pi (hex hashes or null), key (base64) |
Decrypting each slice with its proposer's released key and rebuilding the commitment from the slices' roots gives back the agreed block (Wire formats). Errors: NOT_FOUND for a slot outside the last 64, or one not agreed; INVALID_INPUT for a slot that is not a non-negative integer.
submitTransaction
Takes a signed plain transaction (t = 1) for the proposers named in receivers. The gateway hands it to each of them for header.targetSlot. Pick a target a few slots ahead of the latest slot in getSnapshot.
| Param | Type | Required | Meaning |
|---|---|---|---|
header | TxHeader | yes | the transaction's public header |
transaction | base64, non-empty | yes | the signed Solana transaction |
receivers | array of proposer index, 1 to 3 | yes | the proposers of the target slot to send it to, each once |
Result: Submission.
Errors:
| Code | Cause |
|---|---|
INVALID_INPUT | a receiver is named twice, or the target slot is more than 64 slots ahead |
TRANSACTION_EXPIRED | the target slot has already started |
IDEMPOTENCY_CONFLICT | the same ID was submitted before with a different header or body |
Submitting the same transaction again with the same header and body returns the same result.
submitFragment
Takes one fragment of a t-of-n transaction (t ≥ 2) with its key share, for one receiver. A client sends n calls, one per receiver, each with a different index and receiver and the same header. Threshold transactions says what the parts are; the SDK makes all n calls in one send.
| Param | Type | Required | Meaning |
|---|---|---|---|
header | TxHeader | yes | the transaction's public header, the same in every fragment |
n | integer, 2 to 3 | yes | fragments the transaction is split into |
t | integer, 2 to 3 | yes | fragments needed to rebuild it; at most n |
index | integer, 0 to 2 | yes | this fragment's index, below n |
receiver | proposer index | yes | the proposer this fragment goes to |
fragment | base64, non-empty | yes | this fragment of the ciphertext |
keyShare | base64, non-empty | yes | this receiver's Shamir share of the key |
headerSignature | signature | yes | the fee payer's signature over the header |
Result: Submission.
Errors:
| Code | Cause |
|---|---|
INVALID_INPUT | t > n, index ≥ n, a receiver given two fragments, or the target slot more than 64 slots ahead |
TRANSACTION_EXPIRED | the target slot has started |
CHAIN_REFUSED | the node refused the transaction or fragment; message says why |
IDEMPOTENCY_CONFLICT | the ID was submitted with a different header, n or t, or this index with a different fragment |
getLabReplay
A Fault Lab run with every event it recorded, in the event stream's envelope. The same replay is at GET /v1/lab/runs/{id}/events.
| Param | Type | Required | Meaning |
|---|---|---|---|
runId | string | yes | the run's ID |
Result: LabReplay.
Errors: NOT_FOUND for an unknown run.
Types
NetSnapshot
| Field | Type | Required | Meaning |
|---|---|---|---|
streamId | string | yes | the stream instance |
cursor | integer | yes | the last sequence the snapshot includes; resume after it |
status | "live", "stalled", "unavailable" | yes | the net's status: stalled when slots have stopped arriving |
currentWindow | Window | yes | the window producing now |
recentSlots | Slot[], at most 64 | yes | the most recent slots, oldest first |
upcomingWindows | Window[] | yes | the windows ahead |
counters | Counters | yes | the net's counters |
parameters | Parameters | yes | the protocol parameters the net runs |
Parameters
The protocol parameters the net runs, in microseconds and lamports. Parameters explains each.
| Field | Type | Required | Meaning |
|---|---|---|---|
k | 3 | yes | proposers per window |
kappa | 4 | yes | κ, slots per consensus slot |
w | 16 | yes | slots per window |
deltaLocalUs | 10000 | yes | δlocal |
deltaBlockUs | 50000 | yes | δblock, the length of a slot |
deltaGlobalUs | 250000 | yes | δglobal |
timeoutUs | 750000 | yes | Δtimeout |
tracks | 4 | yes | m, execution tracks per slot |
reserveLamports | "1000000" | yes | ρ, the fee-payer reserve |
trackCapacityCu | integer or null | yes | bcu, compute units per track per slot |
fragmentExpirySlots | integer or null | yes | slots a fragment stays cached after the first accepted one |
alpha | number, 0 to 1 or null | yes | α, the share of windows assigned by hub stake |
minimumHubMembers | integer or null | yes | n_min |
minimumHubStake | u64 string or null | yes | ρ_min, lamports |
Counters
| Field | Type | Required | Meaning |
|---|---|---|---|
slots | integer | yes | slots produced |
finalizedCblocks | integer | yes | cblocks finalized |
skips | integer | yes | consensus slots skipped |
averageCommitSpreadUs | number | yes | mean time from a slot's first to its last commitment |
Window
| Field | Type | Required | Meaning |
|---|---|---|---|
number | integer | yes | the window's number |
hubCode | hub code | yes | the hub holding the window |
firstSlot | integer | yes | its first slot |
lastSlot | integer | yes | its last slot, 15 after the first |
consensusSlots | integer[] | yes | its four consensus slots |
proposers | Proposer[], exactly 3 | yes | its three proposers, by index |
Proposer
| Field | Type | Required | Meaning |
|---|---|---|---|
index | proposer index | yes | its proposer index in the window, 1 to 3 |
identity | address | yes | its validator identity |
stake | u64 string | yes | its stake, lamports |
status | "online", "late", "crashed" | yes | online; late when attested late; crashed when silent since the window started |
Slot
blocks, attestations and executedUs are measured from the slot's start. attestationDeadlineUs and consensusTimeoutUs are measured from the window's ParentReady.
| Field | Type | Required | Meaning |
|---|---|---|---|
slot | integer | yes | the slot number |
wallTime | UTC timestamp | yes | when the slot started |
window | Window | yes | its window |
consensusSlot | integer | yes | the consensus slot it belongs to |
status | "pending", "executed", "finalized", "skipped" | yes | where the slot stands; finalized once its cblock is |
blocks | ProposerBlock[] | yes | each proposer's block |
attestations | Attestation[] | yes | every attestation received for the slot |
agreedSet | array of proposer index or null | yes | P, the accepted proposers; null until agreed |
skip | Skip or null | yes | why the slot was skipped; null otherwise |
mergedOrder | MergedTransaction[] | yes | every transaction of the slot in merged order |
schedule | ExecutionSchedule or null | yes | the four-track schedule; null until merged |
stateHash | hash or null | yes | hash of the state after the slot; null until executed |
xblockHash | hash or null | yes | hash of the slot's execution block |
cblock | Cblock | yes | the cblock the slot belongs to |
executedUs | integer or null | yes | when it executed, µs after the slot's start |
attestationDeadlineUs | integer | yes | the window's attestation deadline, µs after ParentReady |
consensusTimeoutUs | integer | yes | its consensus slot's timeout T(i), µs after ParentReady |
ProposerBlock
| Field | Type | Required | Meaning |
|---|---|---|---|
proposer | proposer index | yes | proposer index |
identity | address | yes | the proposer's identity |
status | "streaming", "sealed", "accepted", "dropped", "missing" | yes | streaming, sealed once committed, accepted in P, dropped when outside P, or missing |
bytes | integer | yes | size of the encrypted block |
slices | Slice[] | yes | its slices |
commitment | Commitment or null | yes | its commitment; null until sent |
attestation | Attestation or null | yes | its proposer's attestation; null until sent |
parent | object or null | yes | in a window's first slot, the parent cblock it names; null otherwise |
parent.consensusSlot | integer | yes | the parent's consensus slot |
parent.hash | hash | yes | the parent's hash |
Slice
| Field | Type | Required | Meaning |
|---|---|---|---|
index | integer | yes | slice index within the block, from 0 |
shredCount | 64 | yes | shreds the slice is coded into |
rebuildShreds | 32 | yes | shreds that rebuild it |
bytes | integer | yes | encrypted size of the slice |
sentUs | integer | yes | when sent, µs after the slot's start |
arrivedUs | integer | yes | when rebuilt at the validator, µs after the slot's start |
merkleRoot | hash | yes | Merkle root over its shreds |
Commitment
| Field | Type | Required | Meaning |
|---|---|---|---|
slot | integer | yes | the slot |
proposer | proposer index | yes | the committing proposer |
hash | hash | yes | h(b), the hash of the encrypted block |
keyHash | hash | yes | H(K), the hash of the block's key, bound in the header |
signature | signature | yes | the proposer's signature over Commit(s, q, h) |
sentUs | integer | yes | when sent, µs after the slot's start |
arrivals | CommitmentArrival[] | yes | its arrival at each co-proposer |
CommitmentArrival
| Field | Type | Required | Meaning |
|---|---|---|---|
receiver | proposer index | yes | the co-proposer it reached |
startUs | integer | yes | the receiver's start[s], µs after the slot's start |
arrivedUs | integer | yes | when it arrived, µs after the slot's start |
relativeToStartUs | integer | yes | arrival minus the receiver's start[s] |
deadlineUs | 20000 | yes | the on-time window, 2δlocal |
onTime | boolean | yes | whether it arrived within the window |
Attestation
| Field | Type | Required | Meaning |
|---|---|---|---|
slot | integer | yes | the slot |
proposer | proposer index | yes | the attesting proposer |
pi | array of hash or null, exactly 3 | yes | π: per proposer, its commitment if on time, null if late |
key | base64 | yes | the attester's block key, released here |
signature | signature | yes | the proposer's signature over the attestation |
sentUs | integer | yes | when sent, µs after the slot's start |
validatorArrivals | object[] | yes | its arrival at each validator |
validatorArrivals.identity | address | yes | the validator |
validatorArrivals.arrivedUs | integer | yes | when it arrived, µs after the slot's start |
Skip
| Field | Type | Required | Meaning |
|---|---|---|---|
reason | SkipReason | yes | why |
detail | string | yes | a sentence on what happened |
disagreeingVectors | Attestation[] | yes | the attestations that disagreed |
affectedSlots | integer[] | yes | every slot the skip covers, to the window's end |
atUs | integer | yes | when the validator decided to skip, µs after the slot's start |
SkipReason
| Value | Meaning |
|---|---|
disagreeing_vectors | two attestations for the slot carry different vectors |
missing_attestation | an attestation of the agreed set did not arrive before the timeout |
equivocation | a proposer signed two blocks or two attestations for the slot |
majority_lost | fewer than two proposers are attested |
window_skipped | an earlier consensus slot of the window was skipped |
MergedTransaction
One entry of a slot's merged order: the transaction's public header plus where it came from and whether it was selected.
| Field | Type | Required | Meaning |
|---|---|---|---|
id | hash | yes | the transaction ID |
feePayer | address | yes | the fee payer |
priorityFeePerCu | u64 string | yes | priority fee, micro-lamports per compute unit |
computeLimit | integer, at least 1 | yes | declared compute limit |
writableAccounts | address[] | yes | accounts it writes |
targetSlot | integer | yes | the slot it was sent for |
kind | "plain", "fragments" | yes | a plain copy, or fragments of a t ≥ 2 transaction |
sourceProposers | array of proposer index | yes | the proposers whose blocks carried it |
n | integer, 1 to 3 | yes | receivers it was sent to |
t | integer, 1 to 3 | yes | threshold |
fragmentIndices | integer[] | yes | for fragments: the indices accepted |
position | integer | yes | its index in the merged order, from 0 |
selected | boolean | yes | whether Algorithm 4 placed it |
exclusion | "capacity", "priority_fee", "incomplete" or null | yes | why not placed: capacity, priority_fee (could not pay above the reserve), or incomplete (fewer than t fragments); null if placed |
ExecutionSchedule
| Field | Type | Required | Meaning |
|---|---|---|---|
algorithm | 4 | yes | always 4: the paper's Algorithm 4 |
tracks | 4 | yes | m, the number of tracks |
capacityCu | integer, at least 1 | yes | bcu, compute units per track |
placements | Placement[] | yes | each selected transaction's place |
gaps | object[] | yes | the free intervals left |
gaps.track | track | yes | the track |
gaps.startCu | integer | yes | where the gap starts, compute units |
gaps.lengthCu | integer | yes | its length, compute units |
Placement
| Field | Type | Required | Meaning |
|---|---|---|---|
track | track | yes | the track |
startCu | integer | yes | its start on the track, compute units |
lengthCu | integer | yes | its compute limit |
txId | hash | yes | the transaction |
Cblock
| Field | Type | Required | Meaning |
|---|---|---|---|
consensusSlot | integer | yes | the consensus slot |
slots | integer[] | yes | its four slots |
parent | object or null | yes | the parent cblock |
parent.consensusSlot | integer | yes | the parent's consensus slot |
parent.hash | hash | yes | the parent's hash |
hash | hash or null | yes | h(c_i), the hash validators vote on; null until assembled |
stateHash | hash or null | yes | hash of the state after its four slots |
votes | Vote[] | yes | votes received |
certificates | Certificate[] | yes | certificates formed |
status | "pending", "notarized", "finalized", "skipped" | yes | where the cblock stands in Alpenglow |
finalizedUs | integer or null | yes | when finalized, µs after its first slot's start |
Vote
| Field | Type | Required | Meaning |
|---|---|---|---|
consensusSlot | integer | yes | the consensus slot |
validator | address | yes | the voter |
kind | "notar", "notar_fallback", "skip", "skip_fallback", "finalize" | yes | the Alpenglow vote |
stakeShare | number, 0 to 1 | yes | the voter's share of total stake |
hash | hash or null | yes | the cblock hash voted for; null for skip |
atUs | integer | yes | when cast, µs after the cblock's first slot |
Certificate
| Field | Type | Required | Meaning |
|---|---|---|---|
consensusSlot | integer | yes | the consensus slot |
kind | "notarization", "notar_fallback", "fast_finalization", "slow_finalization", "skip" | yes | the Alpenglow certificate |
stakeShare | number, 0 to 1 | yes | stake share of its signers |
threshold | number, 0 to 1 | yes | the share it needed: 0.6, or 0.8 for fast finalization |
hash | hash or null | yes | the cblock hash; null for skip |
signers | address[] | yes | the validators whose votes it aggregates |
atUs | integer | yes | when formed, µs after the cblock's first slot |
linkedConsensusSlot | integer or null | yes | on a skip certificate for a later consensus slot of a window: the first skipped consensus slot of that window, whose skip abandoned the rest; null on that first skip and on every other certificate |
Transaction
| Field | Type | Required | Meaning |
|---|---|---|---|
header | TxHeader | yes | its public header |
state | "unknown", "sent", "partly_included", "executed", "finalized", "failed", "expired" | yes | where the transaction stands; Threshold transactions defines each |
kind | "plain", "fragments" | yes | a plain transaction, or fragments of a t ≥ 2 transaction |
n | integer, 1 to 3 | yes | receivers |
t | integer, 1 to 3 | yes | threshold |
receivers | Proposer[] | yes | the proposers it was sent to |
fragments | FragmentInclusion[] | yes | each copy or fragment's inclusion |
includedCount | integer | yes | copies or fragments included so far |
readableSlot | integer or null | yes | the slot its t-th fragment was accepted in |
executedSlot | integer or null | yes | the slot it executed in |
mergedPosition | integer or null | yes | its position in that slot's merged order |
result | "success", "error" or null | yes | success or error, once executed |
logs | string[] | yes | program logs |
failure | string or null | yes | why it failed or expired |
expiresAfterSlot | integer or null | yes | the last slot its fragments stay cached |
finalization | Certificate or null | yes | the certificate that finalized its cblock |
TxHeader
The public header of a transaction, signed by the fee payer. For a t ≥ 2 transaction it is all a proposer and the merge see until the t-th fragment is accepted.
| Field | Type | Required | Meaning |
|---|---|---|---|
id | hash | yes | the transaction ID: for plain, the hash of the signed message; for fragments, the commitment that names it |
feePayer | address | yes | the account charged its fees |
priorityFeePerCu | u64 string | yes | priority fee, micro-lamports per compute unit |
computeLimit | integer, at least 1 | yes | declared compute limit, at least 1 |
writableAccounts | address[] | yes | accounts it writes |
targetSlot | integer | yes | the slot it is sent for |
FragmentInclusion
| Field | Type | Required | Meaning |
|---|---|---|---|
index | integer | yes | fragment index; 0 for a plain copy |
receiver | proposer index | yes | the proposer it was sent to |
slot | integer | yes | the slot it was included in |
proposer | proposer index | yes | the proposer whose block carried it |
includedUs | integer | yes | when included, µs after that slot's start |
Balance
| Field | Type | Required | Meaning |
|---|---|---|---|
address | address | yes | the address |
lamports | u64 string | yes | total balance |
reserveLamports | u64 string | yes | the fee-payer reserve held |
spendableLamports | u64 string | yes | balance above the reserve |
slot | integer | yes | the slot it was read at |
DemoPool
| Field | Type | Required | Meaning |
|---|---|---|---|
address | address | yes | the pool account |
mints | tuple of DemoMint, DemoMint | yes | its two demo mints |
reserves | tuple of u64 string, u64 string | yes | the reserve of each mint, base units, in the order of mints |
feeBps | integer | yes | swap fee, basis points |
slot | integer | yes | the slot it was read at |
DemoMint
| Field | Type | Required | Meaning |
|---|---|---|---|
address | address | yes | the mint |
symbol | string | yes | its symbol |
name | string | yes | its name |
decimals | integer | yes | its decimals |
QuoteRequest
| Field | Type | Required | Meaning |
|---|---|---|---|
inputMint | address | yes | the demo mint you pay in |
amountIn | u64 string | yes | amount in, in the mint's base units; more than 0 |
slippageBps | integer, 0 to 10000 | yes | tolerance for minimumOut, basis points |
Quote
| Field | Type | Required | Meaning |
|---|---|---|---|
inputMint | address | yes | the mint paid in |
outputMint | address | yes | the mint received |
amountIn | u64 string | yes | amount in, base units |
amountOut | u64 string | yes | amount out at the current reserves, base units |
minimumOut | u64 string | yes | amountOut less the slippage tolerance |
feeAmount | u64 string | yes | the pool fee taken from amountIn |
slot | integer | yes | the slot the reserves were read at |
PlainSubmission
| Field | Type | Required | Meaning |
|---|---|---|---|
header | TxHeader | yes | the transaction's public header |
transaction | base64, non-empty | yes | the signed Solana transaction |
receivers | array of proposer index, 1 to 3 | yes | the proposers of the target slot to send it to, each once |
FragmentSubmission
| Field | Type | Required | Meaning |
|---|---|---|---|
header | TxHeader | yes | the transaction's public header, the same in every fragment |
n | integer, 2 to 3 | yes | fragments the transaction is split into |
t | integer, 2 to 3 | yes | fragments needed to rebuild it; at most n |
index | integer, 0 to 2 | yes | this fragment's index, below n |
receiver | proposer index | yes | the proposer this fragment goes to |
fragment | base64, non-empty | yes | this fragment of the ciphertext |
keyShare | base64, non-empty | yes | this receiver's Shamir share of the key |
headerSignature | signature | yes | the fee payer's signature over the header |
Submission
| Field | Type | Required | Meaning |
|---|---|---|---|
id | hash | yes | the transaction ID |
accepted | true | yes | always true; a refusal is an error |
targetSlot | integer | yes | the slot it is queued for |