POST
/
commitments
/
v0
/
reserve_blockspace
Reserves blockspace
curl --request POST \
  --url https://gateway.taiyi-devnet-0.preconfs.org/commitments/v0/reserve_blockspace \
  --header 'Content-Type: application/json' \
  --header 'x-luban-signature: <x-luban-signature>' \
  --data '{
  "gas_limit": "983798",
  "sender": "0xAbcF8e0d4e9587369b2301D0790347320302cc09",
  "recipient": "0xAbcF8e0d4e9587369b2301D0790347320302cc09",
  "deposit": "293872836",
  "tip": "293872836",
  "target_slot": "64",
  "blob_count": "1"
}'
"0729a580-2240-11e6-9eb5-0002a5d5c51b"

Headers

​
x-luban-signature
string<hex>
required

An ECDSA signature from the user over the hash of request body. See here for signature construction.

Example:

"0x8a726dc1d89dc0b10a27130c562cce2d346f2bbac1af683d9b55632825e4abc0480bcf25276452a3c076f2a5d756c6deedd552cfc343dd34a5953835f4d7c8a71c"

Body

application/json

Reserve blockspace request

​
gas_limit
integer
required
Example:

"983798"

​
sender
string<hex>
required

An address on the execution (Ethereum 1) network.

Example:

"0xAbcF8e0d4e9587369b2301D0790347320302cc09"

​
recipient
string<hex>
required

An address on the execution (Ethereum 1) network.

Example:

"0xAbcF8e0d4e9587369b2301D0790347320302cc09"

​
deposit
integer
required

This is the amount deducted from the user's escrow balance when the user fails to submit a transaction for the allocated blockspace.

The deposit is calculated as follows: { gas_limit * gas_fee + blob_count * blob_gas_fee } * 0.5

Example:

"293872836"

​
tip
integer
required

This is the amount deducted from the user's escrow balance along with [deposit] when the user submits a transaction for the allocated blockspace.

The tip is calculated as follows: { gas_limit * gas_fee + blob_count * blob_gas_fee } * 0.5

Example:

"293872836"

​
target_slot
integer
required
Example:

"64"

​
blob_count
integer
required
Required range: 0 <= x <= 6
Example:

"1"

Response

Success

The response is of type string<uuid>.

Example:

"0729a580-2240-11e6-9eb5-0002a5d5c51b"