Skip to content

Commit 53a4358

Browse files
authored
Merge pull request #14 from primevprotocol/update-fund-node
Update fund-node.mdx
2 parents 9366c62 + b01eb53 commit 53a4358

1 file changed

Lines changed: 17 additions & 9 deletions

File tree

get-started/bidders/fund-node.mdx

Lines changed: 17 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,16 @@
11
# Fund Your Node
22

3-
To send bids to provider nodes, the bidder nodes need to prepay the amount to the bidder registry. Funds are locked for each unique bid till the settlement chain settles the commitments. If the bid that was preconfirmed by a provider ends up in the L1 block built by the provider node, we settle the rewards from this amount. If the bid was preconfirmed by a provider which did not build the L1 block, the amount is refunded. If the bid was preconfirmed by a provider who built the block, but the transaction in the bid is not included in the L1 block, the amount is refunded back to the bidder’s balance.
3+
To send bids to provider nodes, bidder nodes need to prepay an amount to the bidder registry. Funds are locked for each unique bid until the settlement process on the mev-commit chain has completed.
44

5-
Bidders can withdraw this balance at any point by interacting with the settlement chain. In order to check or prepay, the user needs to interact with the bidder API.
5+
Given a bid with associated bid _amount_ is preconfirmed by a certain provider, three outcomes are possible:
66

7-
- Check the allowance
7+
* If the provider ends up *not* building the L1 block, _amount_ is refunded to the bidder.
8+
* If the provider builds the L1 block, but the preconfirmed transaction is not included in the L1 block, _amount_ is refunded to the bidder.
9+
* If the corresponding transaction ends up in the L1 block built by the provider, _amount_ is rewarded to the provider.
10+
11+
Bidders can check or add to their prepaid allowance by interacting with the settlement chain via the bidder API.
12+
13+
- To check your prepaid allowance
814

915
```shell
1016
> curl localhost:13523/v1/bidder/get_allowance | jq
@@ -13,9 +19,9 @@ Bidders can withdraw this balance at any point by interacting with the settlemen
1319
}
1420
```
1521

16-
In order to add funds to your allowance, we need to first add funds to the Ethereum wallet created for the node.
22+
To fund your node account with ether on the mev-commit chain.
1723

18-
- Get the Ethereum wallet address of the node
24+
- Get the Ethereum account address of your node
1925

2026
```shell
2127
> curl localhost:13523/topology | jq
@@ -40,7 +46,7 @@ Bidders can withdraw this balance at any point by interacting with the settlemen
4046
}
4147
```
4248

43-
- Add funds to the account. Currently for the testnet, you can use the Primev account to get some testnet ETH. This can be done using the cast command:
49+
- Fund your account with ether on the mev-commit chain. Currently for the testnet, you can use a faucet account to get some mev-commit chain ether. This can be done using the cast command:
4450

4551
```shell
4652
> cast send --rpc-url https://chainrpc.testnet.mev-commit.xyz \
@@ -49,9 +55,11 @@ Bidders can withdraw this balance at any point by interacting with the settlemen
4955
--value 100ether
5056
```
5157

52-
This command will transfer 100 ETH to your `$ADDRESS` which should be enough to get started.
58+
This command will transfer 100 mev-commit chain ETH to your `$ADDRESS` which should be enough to get started.
59+
60+
- Alternatively, use the bridge from Holesky to fund your account. See [bridging-and-fees](https://docs.primev.xyz/get-started/bidders/bridging-and-fees).
5361

54-
- Check the minimum amount that can be added to the allowance. Providers will only authorize bids if the bidder has funds greater than the minimum allowance. The amount is in `wei`
62+
- Check the minimum prepaid allowance to send bids. Providers will only authorize bids if the bidder has funds greater than the minimum allowance. The amount is in `wei`.
5563

5664
```shell
5765
> curl localhost:13523/v1/bidder/get_min_allowance | jq
@@ -60,7 +68,7 @@ Bidders can withdraw this balance at any point by interacting with the settlemen
6068
}
6169
```
6270

63-
- Add allowance
71+
- Add to prepaid allowance
6472

6573
```shell
6674
> curl -X POST localhost/v1/bidder/prepay/10000000000000000000 | jq

0 commit comments

Comments
 (0)