This repository contains example of backend services you can develop using Rockside. Thoses services can be used for example to manage a smartwallet on ios or android client application.
This function deploy a Gnosis Safe smartwallet with the provided account as owner. The transaction is sent to a Rockside Forwarder that will be in charge to forward to the Gnosis Proxy Factory and to payback Rockside Relayer for the Tx gas fees.
First you need to deploy a forwarder using Rockside API. Look at your docs.
On this example we use an EOA managed by Rockside to sign the message. So you have to create an EOA using Rockside API.
curl --location --request POST 'https://api.rockside.io/ethereum/eoa' \
--header 'apikey: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw ''To payback for the transaction fees your forwarder need to have some funds.
For more details on how Rockside can interact with Gnosis Safe, have a look to this repository.
APIKEY: Your Rockside APIKEY
BASE_URL: Rockside base url - https://api.rockside.io
FORWARDER_ADDRESS: Address of the forwarder you deployed
FACTORY_ADDRESS: Address of the Gnosis Proxy factory
SMARTWALLET_IMPL_ADDR: Address of Gnosis Safe Mastercopy
ADMIN_ADDRESS: Address of the EOA managed with Rockside
Gnosis safe mastercopy and factory address can be found here: Gnosis Safe Contract Address
For Ropsten you can use the one we deployed.
Gnosis Safe Proxy Factory: 0x016457118b425fe86952381eC5127F28D4248984
Gnosis Safe Master Copy: 0xB6998f4E968573534D6ea6A500323B0d1cd03767
Request:
curl --location --request POST 'DEPLOY_GNOSIS_FUNC_URL' \
--header 'Content-Type: application/json' \
--data-raw '{
"account": "YOUR_GNOSIS_OWNER_ACCOUNT"
}'Response:
{
"transaction_hash": "0x6663a81a1a827c4bf2301eb169de900c51d2b6e4e2c26d503dce10888f8cdee9",
"tracking_id": "01E9ZSDHMYYFMW3E1CVQ9ADVHK"
}The address of the Gnosis safe can be found on log's data of the transaction receipt
This service allow your client application to get the gas price and the Rockside relayer address to use for sending there transaction depending on the desired speed.
APIKEY: Your Rockside APIKEY
BASE_URL: Rockside base url - https://api.rockside.io
Request:
curl --location --request POST 'GET_TX_PARAMS_URL?network=mainnet' \
--header 'Content-Type: application/json' \
--data-raw '{
"address": "0x4b435b57ab0aa32f169aba415122a4a981dad2a1"
}'Response:
{
{
"speeds": {
"fast": {
"gas_price": "124000000000",
"relayer": "0xb20328AA6B950986798F9755c68DEF45e2631Ec4"
},
"fastest": {
"gas_price": "134000000000",
"relayer": "0xb20328AA6B950986798F9755c68DEF45e2631Ec4"
},
"safelow": {
"gas_price": "112000000000",
"relayer": "0xb20328AA6B950986798F9755c68DEF45e2631Ec4"
},
"standard": {
"gas_price": "116000000000",
"relayer": "0xb20328AA6B950986798F9755c68DEF45e2631Ec4"
}
}
}
}
This service take the encoted data you want to send to your Gnosis Safe Wallet and execute the transaction with rockside relay API.
APIKEY: Your Rockside APIKEY
BASE_URL: Rockside base url - https://api.rockside.io
Request:
curl --location --request POST 'RELAY_TX_URL?network=mainnet' \
--header 'Content-Type: application/json' \
--data-raw '{
"to": "YOUR_GNOSIS_ADDRESS",
"data": "ENCODED_DATA"
}'Response:
{
"transaction_hash": "0x6663a81a1a827c4bf2301eb169de900c51d2b6e4e2c26d503dce10888f8cdee9",
"tracking_id": "01E9ZSDHMYYFMW3E1CVQ9ADVHK"
}Because Rockside can replay your transaction to make it validated faster, the tx hash can change. Use this service to follow the status of your transaction and get the transaction receipt.
Request:
curl --location --request POST 'TX_INFOS_URL/TX_TRACKINGID/?network=mainnet' \
--header 'Content-Type: application/json' \
--data-raw ''Response:
{
"transaction_hash":"0x434223f02fa9f78b788cbed4aa65e8b5760959b82c8c6ea3a069344f3acd8f76",
"tracking_id":"01EHSCRAKA735H777T9WR4JXXT",
"customer_id":"4",
"kind":"smartwallet",
"from":"0xb20328aa6b950986798f9755c68def45e2631ec4",
"to":"0x4b435b57ab0aa32f169aba415122a4a981dad2a1",
"data_length":484,
"value":0,
"gas":67092,
"gas_price":135000000000,
"gas_price_limit":135000000000,
"chain_id":1,
"price_mode":3,
"deadline":"2020-09-09T12:17:27.463Z",
"receipt":{
"status":1,
"cumulative_gas_used":4170941,
"logs":[
{
"address":"0x4b435b57ab0aa32f169aba415122a4a981dad2a1",
"topics":[
"0x442e715f626346e8c54381002da614f62bee8d27386535b2521ec8540898556e"
],
"data":"0x61a7f9db8074a9e6757daa3fe2aadbfcdc0e805e2d40802522574691f71bb52e00000000000000000000000000000000000000000000000000195cf243606c00",
"blockNumber":"0xa536bc",
"transactionHash":"0x434223f02fa9f78b788cbed4aa65e8b5760959b82c8c6ea3a069344f3acd8f76",
"transactionIndex":"0x3f",
"blockHash":"0x79efa81883115f864c095fcb2e6dea642a4e3af82fda3dd2db0e59518fc07c0d",
"logIndex":"0x69",
"removed":false
}
],
"transaction_hash":"0x434223f02fa9f78b788cbed4aa65e8b5760959b82c8c6ea3a069344f3acd8f76",
"contract_address":"0x0000000000000000000000000000000000000000",
"gas_used":59738,
"block_hash":"0x79efa81883115f864c095fcb2e6dea642a4e3af82fda3dd2db0e59518fc07c0d",
"block_number":10827452,
"transaction_index":63
},
"created":"2020-09-09T12:16:57.463Z",
"updated":"2020-09-09T12:17:25.658Z",
"status":"success",
"user_savings":0,
"extra_cost":0,
"mining_time_estimate":28
}APIKEY: Your Rockside APIKEY
BASE_URL: Rockside base url - https://api.rockside.io