RPC endpoints

Our RPC endpoints adhere to the JSON-RPC 2.0 specification.

• A public Alpen RPC server is located at: https://rpc.testnet.alpenlabs.io

For example, to call the strata_protocolVersion method, you can use curl:

curl --location 'https://rpc.testnet.alpenlabs.io' \
--header 'Content-Type: application/json' \
--data '{
  "jsonrpc":"2.0",
  "method":"strata_protocolVersion",
  "params":[],
  "id": 1
}'

Strata client methods

In addition to the standard Reth API methods, Alpen full nodes make available the following Strata-related client methods:

RPC method	Description	Link
strata_protocolVersion	The protocol version of the node.	strata_protocolVersion
strata_blockTime	Strata's block time in milliseconds.	strata_blockTime
strata_l1connected	Checks if the node is connected to the bitcoin network.	strata_l1connected
strata_l1status	Provides the status of the L1 (Bitcoin) network connection and sync state.	strata_l1status
strata_getL1blockHash	Retrieves the L1 (Bitcoin) block hash at a specific height.	strata_getL1blockHash
strata_clientStatus	Returns the current status of the Strata client.	strata_clientStatus
strata_getRecentBlockHeaders	Retrieves the most recent Strata block headers.	strata_getRecentBlockHeaders
strata_getHeadersAtIdx	Retrieves the Strata block headers starting from a specific index.	strata_getHeadersAtIdx
strata_getHeaderById	Retrieves a Strata block header by its ID.	strata_getHeaderById
strata_getExecUpdateById	Retrieves the execution update for a specific Strata block.	strata_getExecUpdateById
strata_getEpochCommitments	Retrieves the list of epoch commitments for a specific epoch.	strata_getEpochCommitments
strata_getEpochSummary	Retrieves the summary for a specific epoch.	strata_getEpochSummary
strata_getChainstateRaw	Retrieves the raw data for chainstate at a specific slot.	strata_getChainstateRaw
strata_getCLBlockWitness	Retrieves the client layer (CL) raw block witness data for a specific Strata block index.	strata_getCLBlockWitness
strata_getCurrentDeposits	Retrieves the current list of deposit IDs.	strata_getCurrentDeposits
strata_getCurrentDepositById	Retrieves details of a deposit by its ID.	strata_getCurrentDepositById
strata_syncStatus	Retrieves the current synchronization status of the Strata node.	strata_syncStatus
strata_getRawBundles	Retrieves raw data bundles between a range of Strata block heights.	strata_getRawBundles
strata_getRawBundleById	Retrieves the raw data bundle for a specific Strata block.	strata_getRawBundleById
strata_getCheckpointInfo	Gets nth checkpoint info if any	strata_getCheckpointInfo
strata_getLatestCheckpointIndex	Gets index of the latest checkpoint.	strata_getLatestCheckpointIndex
strata_getCheckpointConfStatus	Gets confirmation status of nth checkpoint if exists.	strata_getCheckpointConfStatus
strata_getL2BlockStatus	Gets the L2 (Strata) block status from its height.	strata_getL2BlockStatus
strata_getSyncEvent	Gets the sync even by index.	strata_getSyncEvent
strata_getLastSyncEventIdx	Gets the index of the last written sync event.	strata_getLastSyncEventIdx
strata_getClientUpdateOutput	Gets the client update output produced as a result of the sync event idx given.	strata_getClientUpdateOutput

strata_protocolVersion

The protocol version of the node.

• Parameters: This method takes no parameters.

• Returns: A standalone 64-bit unsigned integer representing the protocol version.

strata_blockTime

Strata's block time in milliseconds.

• Parameters: This method takes no parameters.

• Returns: A standalone 64-bit unsigned integer representing the block time in milliseconds.

strata_l1connected

If the node is connected to the bitcoin network.

• Parameters: This method takes no parameters.

• Returns: A standalone Boolean variable (true if connected, false otherwise).

strata_l1status

The status of the bitcoin network connection, including sync state and other relevant information.

• Parameters: This method takes no parameters.

• Returns: A JSON object containing the following fields:

  • bitcoin_rpc_connected (Boolean): If the last time the node tried to poll the bitcoin client were successful.

  • last_rpc_error (optional string): The last error message received when trying to poll the bitcoin client, if there was one.

  • cur_height (64-bit unsigned integer): Current block height.

  • cur_tip_blkid (string): Current tip block ID as string.

  • last_published_txid (optional string): Last published txid where a Strata blob was present

  • published_envelope_count (64-bit unsigned integer): number of published transactions in current run

  • last_update (64-bit unsigned integer): UNIX millis time of the last time we got a new update from the L1 connector.

  • network (string): The underlying (bitcoin) network type, e.g. "signet".

strata_getL1blockHash

The bitcoin block hash at a certain height.

• Parameters:

  • "height": A 64-bit unsigned integer representing the block height.

• Returns: A string representing the block hash, or null if the block hash is unavailable.

strata_clientStatus

The current status of the Strata client.

• Parameters: This method takes no parameters.

• Returns: A JSON object containing the following fields:

  • finalized_epoch Commitment to the last finalized epoch, which is a JSON object containing the following fields if a finalized epoch exists, or null:

    • "epoch" (64-bit unsigned integer): The index of the epoch.

    • "last_slot" (64-bit unsigned integer): The last slot of the epoch.

    • "last_blkid" (hex-encoded string): The last strata block ID of the epoch.

  • confirmed_epoch Commitment to the last confirmed epoch, which is a JSON object containing the following fields if a confirmed epoch exists, or null:

    • "epoch" (64-bit unsigned integer): The index of the epoch.

    • "last_slot" (64-bit unsigned integer): The last slot of the epoch.

    • "last_blkid" (hex-encoded string): The last strata block ID of the epoch.

  • tip_l1_block Commitment to the Bitcoin chain tip being followed by the strata node, which is a JSON object containing the following fields, if one exists.

    • height (64-bit unsigned integer): The height of the Bitcoin block.

    • blkid (hex-encoded string): The Bitcoin block id.

  • buried_l1_block Commitment to the Bitcoin block treated as being "buried" and without possibility of being reorg'ed which is a JSON object containing the following fields, if one exists.

    • height (64-bit unsigned integer): The height of the Bitcoin block.

    • blkid (hex-encoded string): The Bitcoin block id.

  • (deprecated) chain_tip (hex-encoded string): Blockchain tip.

  • (deprecated) chain_tip_slot (64-bit unsigned integer): Bitcoin chain tip slot.

  • (deprecated) finalized_blkid (hex-encoded string): Strata block that's been finalized and proven on L1 (Bitcoin).

  • (deprecated) last_l1_block (hex-encoded string): Recent bitcoin block that might still suffer a reorg.

  • (deprecated) buried_l1_height (64-bit unsigned integer): Bitcoin block index treated as being "buried" and without possibility of being reorg'ed.

strata_getRecentBlockHeaders

Retrieves the most recent Strata block headers.

• Parameters:

  • "count": A 64-bit unsigned integer representing the number of block headers to retrieve.

• Returns: An array of JSON objects containing the following fields:

  • block_idx (64-bit unsigned integer): The index of the block representing height.

  • timestamp (64-bit unsigned integer): The timestamp of when the block was created in UNIX epoch format.

  • block_id (hex-encoded string): Hash of the block's contents.

  • prev_block (hex-encoded string): Previous block.

  • l1_segment_hash (hex-encoded string): Bitcoin segment hash.

  • exec_segment_hash (hex-encoded string): Hash of the execution segment.

  • state_root (hex-encoded string): The root hash of the state tree.

strata_getHeadersAtIdx

Retrieves the Strata block headers starting from a specific index.

• Parameters:

  • "index": A 64-bit unsigned integer representing the starting index.

• Returns: An array of JSON objects containing the following fields, or null if the Strata block headers at the desired index cannot be found:

  • block_idx (64-bit unsigned integer): The index of the block representing height.

  • timestamp (64-bit unsigned integer): The timestamp of when the block was created in UNIX epoch format.

  • block_id (hex-encoded string): Hash of the block's contents.

  • prev_block (hex-encoded string): Previous block.

  • l1_segment_hash (hex-encoded string): Bitcoin segment hash.

  • exec_segment_hash (hex-encoded string): Hash of the execution segment.

  • state_root (hex-encoded string): The root hash of the state tree.

strata_getHeaderById

Retrieves a Strata block header by its ID.

• Parameters:

  • "block_id": An identifier for the Strata block as a 32-byte array.

• Returns: A JSON object containing the following fields, or null if the desired Strata block cannot be found:

  • block_idx (64-bit unsigned integer): The index of the block representing height.

  • timestamp (64-bit unsigned integer): The timestamp of when the block was created in UNIX epoch format.

  • block_id (hex-encoded string): Hash of the block's contents.

  • prev_block (hex-encoded string): Previous block.

  • l1_segment_hash (hex-encoded string): Bitcoin segment hash.

  • exec_segment_hash (hex-encoded string): Hash of the execution segment.

  • state_root (hex-encoded string): The root hash of the state tree.

strata_getExecUpdateById

Retrieves the execution update for a specific Strata block.

• Parameters:

  • "block_id": An identifier for the Strata block as a 32-byte array.

• Returns: A JSON object containing the following fields, or null if the execution update for the desired Strata block cannot be found:

  • update_idx (64-bit unsigned integer): The index of the update, used to track or sequence updates.

  • entries_root (hex-encoded string): Merkle tree root of the contents of the EL (execution layer) payload, in the order it was "strata'ed" in the block.

  • extra_payload (hex-encoded string): Buffer of any other payload data.

  • new_state (hex-encoded string): New state root for the update.

  • withdrawals: Bridge withdrawals intents, which is a vector of JSON objects containing the following fields:

    • amt (64-bit unsigned integer): bitcoin amount in sats.

    • destination: destination bitcoin address for withdrawal.

    • withdrawal_txid(hex-encoded string): Txid of withdrawal transaction in Alpen chain.

  • da_blobs: Bitcoin DA (data availability) blobs, which is vector of JSON objects containing the following fields:

    • dest (8-bit unsigned integer): destination or identifier for the blob.

    • blob-commitment (32-byte hex-encoded string): commitment hash for the blob.

strata_getEpochCommitments

Retrieves the list of epoch commitments for a specific epoch.

• Parameters:

  • "epoch": A 64-bit unsigned integer representing the epoch index.

• Returns: An array of JSON objects containing the following fields:

  • "epoch" (64-bit unsigned integer): The index of the epoch.

  • "last_slot" (64-bit unsigned integer): The last slot of the epoch.

  • "last_blkid" (hex-encoded string): The Id of the last strata block of the epoch.

strata_getEpochSummary

Retrieves the summary for a specific epoch. The inputs correspond to the returns from strata_getEpochCommitments.

• Parameters:

  • "epoch" (64-bit unsigned integer): The epoch index.

  • "slot" (64-bit unsigned integer): The last slot of the epoch.

  • "terminal" (hex-encoded string): The last block ID of the epoch.

• Returns: A JSON object containing the following fields, or null if the epoch summary the desired Strata epoch cannot be found:

  • "epoch" (64-bit unsigned integer): The index of the epoch.

  • "terminal" Commitment to the last block of the checkpoint, which is a JSON object containing the following fields:

    • "slot" (64-bit unsigned integer): The index of the block.

    • "blkid" (hex-encoded string): The ID of the block.

  • "prev_terminal" Commitment to the last block of the previous checkpoint, which is a JSON object containing the following fields:

    • "slot" (64-bit unsigned integer): The index of the block.

    • "blkid" (hex-encoded string): The ID of the block.

  • "new_l1" Commitment to the final L1 block included in the checkpoint, which is a JSON object containing the following fields:

    • "height" (64-bit unsigned integer): The height of the L1 block.

    • "blkid" (hex-encoded string): The ID of the L1 block.

  • "final_state" (hex-encoded string): The final state root of the epoch.

strata_getChainstateRaw

Retrieves the raw data for chainstate at a specific slot.

• Parameters:

  • "slot": A 64-bit unsigned integer representing the slot.

• Returns: Raw bytes, or error if the chainstate for the desired Strata block cannot be found.

strata_getCLBlockWitness

Retrieves the client layer (CL) raw block witness data for a specific Strata block index.

• Parameters:

  • "block_id": An identifier for the Strata block as a 32-byte array.

• Returns: Raw bytes, or null if the block witness data for the desired Strata block cannot be found.

strata_getCurrentDeposits

Retrieves the current list of deposit IDs.

• Parameters: This method takes no parameters.

• Returns: An array of 32-bit unsigned integers representing the active deposit IDs.

strata_getCurrentDepositById

Retrieves details of a deposit by its ID.

• Parameters:

  • "deposit_id": A 32-bit unsigned integer representing the deposit ID.

• Returns: A JSON object containing the following fields, or null if the deposit cannot be found:

  • deposit_idx (32-bit unsigned integer): The index of the deposit, used to identify or track the deposit within the system.

  • output (string): The outpoint (txid:vout) that this deposit entry references.

  • notary_operators (vector of u32): list of notary operators, by their indexes.

  • amt (64-bit unsigned integer): The amount of currency deposited.

  • state (string): The deposit state:

    • "Created"

    • "Accepted"

    • "Dispatched"

    • "Executed"

  • withdrawal_request_txid (optional 32-byte hex-encoded string): Txid of withdrawal request transaction in Alpen chain if assined to this deposit, or null if unassigned.

strata_syncStatus

Retrieves the current synchronization status of the Strata node.

• Parameters: This method takes no parameters.

• Returns: A JSON object containing the following fields:

  • tip_height (64-bit unsigned integer): Current head Strata slot known to this node

  • tip_block_id (32-byte array): Last Strata block chosen as the current tip.

  • cur_epoch (64-bit unsigned integer): Current epoch index.

  • prev_epoch: Commitment to the previous epoch, which is a JSON object containing the following fields:

    • "epoch" (64-bit unsigned integer): The index of the epoch.

    • "last_slot" (64-bit unsigned integer): The last slot of the epoch.

    • "last_blkid" (hex-encoded string): The last strata block ID of the epoch.

  • observed_finalized_epoch: Commitment to the last finalized epoch observed in chainstate, which is a JSON object containing the following fields:

    • "epoch" (64-bit unsigned integer): The index of the epoch.

    • "last_slot" (64-bit unsigned integer): The last slot of the epoch.

    • "last_blkid" (hex-encoded string): The last strata block ID of the epoch.

  • safe_l1_block: Commitment to the last Bitcoin block processed on the strata chain.

    • height (64-bit unsigned integer): The height of the Bitcoin block.

    • blkid (hex-encoded string): The Bitcoin block id.

  • (deprecated)finalized_block_id (32-byte array): Strata block that's been finalized and proven on L1 (Bitcoin).

strata_getRawBundles

Retrieves raw data bundles between a range of Strata block heights.

• Parameters:

  • "start_height": A 64-bit unsigned integer representing the starting block height.

  • "end_height": A 64-bit unsigned integer representing the ending block height.

• Returns: A hex-encoded string representing the raw data bundles for the given block height range.

strata_getRawBundleById

Retrieves the raw data bundle for a specific Strata block.

• Parameters:

  • "block_id": The Strata block identifier.

• Returns: A hex-encoded string representing the raw data bundle, or null if the bundle is not found.

strata_getCheckpointInfo

Gets nth checkpoint info.

• Parameters:

  • "idx": A 64-bit unsigned integer representing the checkpoint index.

• Returns: A JSON object containing the following fields, or null if no checkpoints could be found:

  • "idx": A 64-bit unsigned integer representing the checkpoint index.

  • "l1_range": A tuple of commitments to start and end bitcoin blocks in the range of the checkpoint, which is a JSON object containing the following fields:

    • "height" (64-bit unsigned integer): The height of the L1 block.

    • "blkid" (hex-encoded string): The ID of the L1 block.

  • "l2_range": A tuple of commitments to start and end strata blocks in the range of the checkpoint, which is a JSON object containing the following fields:

    • "slot" (64-bit unsigned integer): The slot of the Strata block.

    • "blkid" (hex-encoded string): The ID of the Strata block.

  • "l1_reference": A JSON object containing the following fields representing the bitcoin block and tx where the checkpoint is posted.

    • "block_height" (64-bit unsigned integer): The height of the L1 block.

    • "block_id" (hex-encoded string): The ID of the L1 block.

    • "txid" (hex-encoded string): The txid of the Bitcoin transaction containing the envelope with the checkpoint.

    • "wtxid" (hex-encoded string): The wtxid of the Bitcoin transaction containing the envelope with the checkpoint..

  • "confirmation_status" (string): The status of the checkpoint, one of:

    • "pending"

    • "confirmed"

    • "finalized"

strata_getLatestCheckpointIndex

Gets index of the latest checkpoint.

• Parameters:

  • "finalized" An optional Boolean. Default false. Only relevant for sequencer nodes.

• Returns: A 64-bit unsigned integer representing the latest checkpoint index.

strata_getCheckpointConfStatus

Gets confirmation status of nth checkpoint if exists.

• Parameters:

  • "idx" A 64-bit unsigned integer representing the checkpoint index.

• Returns: (string): The status of the checkpoint, or null if the checkpoint could not be found:

  • "pending"

  • "confirmed"

  • "finalized"

strata_getL2BlockStatus

Gets the Strata block status from its height.

• Parameters:

  • "block_height": A 64-bit unsigned integer representing the Strata block height that the checkpoint covers.

• Returns The status of the Strata block:

  • "Unknown"

  • "Confirmed"

  • "Verified"

  • "Finalized"

strata_getSyncEvent

Gets the sync even by index.

• Parameters: a 64-bit unsigned integer representing the sync event index.

• Returns: A JSON object being one of the following variants, or null if no sync event could be found:

  • "L1Block": In the case of a valid L1 (bitcoin) block.

  • "L1Revert": In the case of a valid L1 (bitcoin) revert.

strata_getLastSyncEventIdx

Gets the index of the last written sync event.

• Parameters: This method takes no parameters.

• Returns: A 64-bit unsigned integer representing the last written sync event index.

strata_getClientUpdateOutput

Gets the client update output produced as a result of the sync event index given.

• Parameters: a 64-bit unsigned integer representing the sync event index.

• Returns: A JSON object containing the following fields, or null if no sync event could be found:

  • "state": a JSON object representing the client state after applying the sync event.

  • "actions": a vector of JSON objects, each representing an action to be taken by the client.

    • "FinalizeEpoch": Finalizes an epoch, indicating that it won't be reverted.

    • "L2Genesis": Indicates to the worker that it's safe to perform the L2 (Strata) genesis operations and start the chain sync work, using a particular L1 block as the genesis lock-in block.

    • "UpdateCheckpointInclusion": Checkpoint is included in L1 at given L1 reference.

Account abstraction

Alpen includes support for account abstraction (AA) following the ERC-4337 standard. In our implementation we deployed EntryPoint contracts and a Bundler.

EntryPoint Contract

Developers can access it using the following addresses:

Version	Contract Address
v0.6	0x5ff137d4b0fdcd49dca30c7cf57e578a026d2789
v0.7	0x0000000071727De22E5E9d8BAf0edAc6f37da032
v0.8	0x4337084D9E255Ff0702461CF8895CE9E3b5Ff108
v0.9	0x433709009B8330FDa32311DF1C2AFA402eD8D009

Bundler

Alpen is offering a Rundler v.0.11.0 public bundler RPC at https://bundler.testnet.alpenlabs.io .

For example, to call the eth_supportedEntryPoints method, we can use curl:

curl --location 'https://bundler.testnet.alpenlabs.io' \
--header 'Content-Type: application/json' \
--data '{
  "jsonrpc":"2.0",
  "method":"eth_supportedEntryPoints",
  "params":[],
  "id": 1
}'

These RPC endpoints follow the EIP-7769 specification:

Endpoint	Description
eth_sendUserOperation	Sends a UserOperation to the bundler for inclusion.
eth_estimateUserOperationGas	Estimates gas usage for a given UserOperation.
eth_getUserOperationByHash	Fetches a UserOperation by its userOpHash.
eth_getUserOperationReceipt	Retrieves the receipt for a submitted UserOperation.
eth_supportedEntryPoints	Lists supported EntryPoint addresses.