View Source Signet.RPC (Signet v1.0.0-alpha3)

Excessively simple RPC client for Ethereum.

Summary

Functions

RPC call to call a transaction and preview results.

RPC call to call to estimate gas used by a given call.

Helper function to work with other Signet modules to get a nonce, sign a transction, and transmit it to the network.

RPC call to call to get the current gas price.

RPC call to get account nonce.

RPC call to get a transaction receipt. Note, this will return {:ok, %Signet.Receipt{}} or {:ok, nil} if the receipt is not yet available.

Helper function to work with other Signet modules to get a nonce, sign a transction, and prepare it to be submitted on-chain.

Simple RPC client for a JSON-RPC Ethereum node.

RPC call to send a raw transaction.

RPC call to get a transaction receipt

Functions

Link to this function

call_trx(trx, opts \\ [])

View Source

RPC call to call a transaction and preview results.

Examples

iex> Signet.Transaction.V1.new(1, {100, :gwei}, 100_000, <<1::160>>, {2, :wei}, <<1, 2, 3>>)
iex> |> Signet.RPC.call_trx()
{:ok, <<0x0c>>}

iex> Signet.Transaction.V2.new(1, {1, :gwei}, {100, :gwei}, 100_000, <<1::160>>, {2, :wei}, <<1, 2, 3>>, [<<2::160>>, <<3::160>>], :goerli)
iex> |> Signet.RPC.call_trx()
{:ok, <<0x0d>>}

iex> Signet.Transaction.V1.new(1, {100, :gwei}, 100_000, <<1::160>>, {2, :wei}, <<1, 2, 3>>)
iex> |> Signet.RPC.call_trx(decode: :hex_unsigned)
{:ok, 0x0c}

iex> Signet.Transaction.V1.new(1, {100, :gwei}, 100_000, <<10::160>>, {2, :wei}, <<1, 2, 3>>)
iex> |> Signet.RPC.call_trx()
{:error, "error 3: execution reverted (0x3d738b2e)"}

iex> errors = ["Unauthorized()", "BadNonce()", "NotEnoughSigners()", "NotActiveWithdrawalAddress()", "NotActiveOperator()", "DuplicateSigners()"]
iex> Signet.Transaction.V1.new(1, {100, :gwei}, 100_000, <<10::160>>, {2, :wei}, <<1, 2, 3>>)
iex> |> Signet.RPC.call_trx(errors: errors)
{:error, "error 3: execution reverted (NotActiveOperator()[])"}

iex> errors = ["Cool(uint256,string)"]
iex> Signet.Transaction.V1.new(1, {100, :gwei}, 100_000, <<11::160>>, {2, :wei}, <<1, 2, 3>>)
iex> |> Signet.RPC.call_trx(errors: errors)
{:error, "error 3: execution reverted (Cool(uint256,string)[1, \"cat\"])"}
Link to this function

estimate_gas(trx, opts \\ [])

View Source

RPC call to call to estimate gas used by a given call.

Examples

iex> Signet.Transaction.V1.new(1, {100, :gwei}, 100_000, <<1::160>>, {2, :wei}, <<1, 2, 3>>)
iex> |> Signet.RPC.estimate_gas()
{:ok, 0x0d}

iex> Signet.Transaction.V2.new(1, {1, :gwei}, {100, :gwei}, 100_000, <<1::160>>, {2, :wei}, <<1, 2, 3>>, [<<2::160>>, <<3::160>>], :goerli)
iex> |> Signet.RPC.estimate_gas()
{:ok, 0xdd}
Link to this function

execute_trx(contract, call_data, opts \\ [])

View Source

Helper function to work with other Signet modules to get a nonce, sign a transction, and transmit it to the network.

If you need higher-level functionality, like manual nonce tracking, you may want to use the more granular function calls.

Options:

  • gas_price - Set the base gas for the transaction, overrides all other gas prices listed below (default nil) [note: only compatible with V1 transaction]
  • base_fee - Set the base price for the transaction, if nil, will use base gas price from eth_gasPrice call (default nil) [note: only compatible with V2 transactions]
  • base_fee_buffer - Buffer for the gas price when estimating gas (default: 1.2 = 120%) [note: only compatible with V2 transactions]
  • priority_fee - Additional gas to send as a priority fee. (default: {0, :gwei}) [note: only compatible with V2 transactions]
  • gas_limit - Set the gas limit for the transaction (default: calls eth_estimateGas)
  • gas_buffer - Buffer if estimating gas limit (default: 1.5 = 150%)
  • value - Value to provide with transaction in wei (default: 0)
  • nonce - Nonce to send with transaction. (default: lookup via eth_transactionCount)
  • verify - Verify the function is likely to succeed (default: true)
  • trx_type - :v1 for V1 (pre-EIP-1559 transactions), :v2 for V2 (EIP-1559) transactions, and nil for auto-detect.

Note: if we don't verify, then estimateGas will likely fail if the transaction were to fail.

    To prevent this, `gas_limit` should always be supplied when `verify` is set to false.

Examples

iex> signer_proc = Signet.Test.Signer.start_signer()
iex> {:ok, trx_id} = Signet.RPC.execute_trx(<<1::160>>, {"baz(uint,address)", [50, :binary.decode_unsigned(<<1::160>>)]}, gas_price: {50, :gwei}, value: 0, signer: signer_proc)
iex> <<nonce::integer-size(8), gas_price::integer-size(64), gas_limit::integer-size(24), to::binary>> = trx_id
iex> {nonce, gas_price, gas_limit, to}
{4, 50000000000, 20, <<1::160>>}

iex> signer_proc = Signet.Test.Signer.start_signer()
iex> Signet.RPC.execute_trx(<<10::160>>, {"baz(uint,address)", [50, <<1::160>> |> :binary.decode_unsigned]}, gas_price: {50, :gwei}, gas_limit: 100_000, value: 0, nonce: 10, signer: signer_proc)
{:error, "error 3: execution reverted (0x3d738b2e)"}

iex> # Set base fee and priority fee (v2)
iex> signer_proc = Signet.Test.Signer.start_signer()
iex> {:ok, trx_id} = Signet.RPC.execute_trx(<<10::160>>, {"baz(uint,address)", [50, <<1::160>> |> :binary.decode_unsigned]}, base_fee: {1, :gwei}, priority_fee: {3, :gwei}, gas_limit: 100_000, value: 0, nonce: 10, verify: false, signer: signer_proc)
iex> <<nonce::integer-size(8), max_priority_fee_per_gas::integer-size(64), max_fee_per_gas::integer-size(64), gas_limit::integer-size(24), to::binary>> = trx_id
iex> {nonce, max_priority_fee_per_gas, max_fee_per_gas, gas_limit, to}
{10, 3000000000, 1000000000, 100000, <<10::160>>}

RPC call to call to get the current gas price.

Examples

iex> Signet.RPC.gas_price()
{:ok, 1000000000}
Link to this function

get_nonce(account, opts \\ [])

View Source

RPC call to get account nonce.

Examples

iex> Signet.RPC.get_nonce(Signet.Util.decode_hex!("0x407d73d8a49eeb85d32cf465507dd71d507100c1"))
{:ok, 4}
Link to this function

get_trx_receipt(trx_id, opts \\ [])

View Source
@spec get_trx_receipt(binary() | String.t(), Keyword.t()) ::
  {:ok, Signet.Receipt.t() | nil} | {:error, term()}

RPC call to get a transaction receipt. Note, this will return {:ok, %Signet.Receipt{}} or {:ok, nil} if the receipt is not yet available.

Examples

iex> Signet.RPC.get_trx_receipt(Signet.Util.decode_hex!("0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"))
{:ok,
  %Signet.Receipt{
    transaction_hash: Signet.Util.decode_hex!("0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"),
    transaction_index: 0x66,
    block_hash: Signet.Util.decode_hex!("0xa957d47df264a31badc3ae823e10ac1d444b098d9b73d204c40426e57f47e8c3"),
    block_number: 0xeff35f,
    from: Signet.Util.decode_hex!("0x6221a9c005f6e47eb398fd867784cacfdcfff4e7"),
    to: Signet.Util.decode_hex!("0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"),
    cumulative_gas_used: 0xa12515,
    effective_gas_price: 0x5a9c688d4,
    gas_used: 0xb4c8,
    contract_address: nil,
    logs: [
      %Signet.Receipt.Log{
        log_index: 1,
        block_number: 0x01b4,
        block_hash: Signet.Util.decode_hex!("0xaa8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d"),
        transaction_hash: Signet.Util.decode_hex!("0xaadf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf"),
        transaction_index: 0,
        address: Signet.Util.decode_hex!("0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d"),
        data: Signet.Util.decode_hex!("0x0000000000000000000000000000000000000000000000000000000000000000"),
        topics: [
          Signet.Util.decode_hex!("0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5")
        ]
      }
    ],
    logs_bloom: Signet.Util.decode_hex!("0x00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001"),
    type: 0x02,
    status: 0x01,
  }
}

iex> Signet.RPC.get_trx_receipt("0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5")
{:ok,
  %Signet.Receipt{
    transaction_hash: Signet.Util.decode_hex!("0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"),
    transaction_index: 0x66,
    block_hash: Signet.Util.decode_hex!("0xa957d47df264a31badc3ae823e10ac1d444b098d9b73d204c40426e57f47e8c3"),
    block_number: 0xeff35f,
    from: Signet.Util.decode_hex!("0x6221a9c005f6e47eb398fd867784cacfdcfff4e7"),
    to: Signet.Util.decode_hex!("0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"),
    cumulative_gas_used: 0xa12515,
    effective_gas_price: 0x5a9c688d4,
    gas_used: 0xb4c8,
    contract_address: nil,
    logs: [
      %Signet.Receipt.Log{
        log_index: 1,
        block_number: 0x01b4,
        block_hash: Signet.Util.decode_hex!("0xaa8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d"),
        transaction_hash: Signet.Util.decode_hex!("0xaadf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf"),
        transaction_index: 0,
        address: Signet.Util.decode_hex!("0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d"),
        data: Signet.Util.decode_hex!("0x0000000000000000000000000000000000000000000000000000000000000000"),
        topics: [
          Signet.Util.decode_hex!("0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5")
        ]
      }
    ],
    logs_bloom: Signet.Util.decode_hex!("0x00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001"),
    type: 0x02,
    status: 0x01,
  }
}

iex> Signet.RPC.get_trx_receipt("0xf9e69be4f1ae524854e14dc820c519d8f2b86e52c60e54448abf920d22fb6fe2")
{:ok, %Signet.Receipt{
  transaction_hash: Signet.Util.decode_hex!("0xf9e69be4f1ae524854e14dc820c519d8f2b86e52c60e54448abf920d22fb6fe2"),
  transaction_index: 0,
  block_hash: Signet.Util.decode_hex!("0x4bc3c26b1a599ced9876d9bf9a17c9bd58ec8b71a68e75335de7f2820e9336ca"),
  block_number: 10493428,
  from: Signet.Util.decode_hex!("0xb03d1100c68e58aa1895f8c1f230c0851ff41851"),
  to: Signet.Util.decode_hex!("0x9d8ec03e9ddb71f04da9db1e38837aaac1782a97"),
  cumulative_gas_used: 222642,
  effective_gas_price: 1200000010,
  gas_used: 222642,
  contract_address: nil,
  logs: [
    %Signet.Receipt.Log{
      log_index: 0,
      block_number: 10493428,
      block_hash: Signet.Util.decode_hex!("0x4bc3c26b1a599ced9876d9bf9a17c9bd58ec8b71a68e75335de7f2820e9336ca"),
      transaction_hash: Signet.Util.decode_hex!("0xf9e69be4f1ae524854e14dc820c519d8f2b86e52c60e54448abf920d22fb6fe2"),
      transaction_index: 0,
      address: Signet.Util.decode_hex!("0x9d8ec03e9ddb71f04da9db1e38837aaac1782a97"),
      data: Signet.Util.decode_hex!("0x000000000000000000000000cb372382aa9a9e6f926714f4305afac4566f75380000000000000000000000000000000000000000000000000000000000000000"),
      topics: [
        Signet.Util.decode_hex!("0x3ffe5de331422c5ec98e2d9ced07156f640bb51e235ef956e50263d4b28d3ae4"),
        Signet.Util.decode_hex!("0x0000000000000000000000002326aba712500ae3114b664aeb51dba2c2fb416d"),
        Signet.Util.decode_hex!("0x0000000000000000000000002326aba712500ae3114b664aeb51dba2c2fb416d")
      ]
    },
    %Signet.Receipt.Log{
      log_index: 1,
      block_number: 10493428,
      block_hash: Signet.Util.decode_hex!("0x4bc3c26b1a599ced9876d9bf9a17c9bd58ec8b71a68e75335de7f2820e9336ca"),
      transaction_hash: Signet.Util.decode_hex!("0xf9e69be4f1ae524854e14dc820c519d8f2b86e52c60e54448abf920d22fb6fe2"),
      transaction_index: 0,
      address: Signet.Util.decode_hex!("0xcb372382aa9a9e6f926714f4305afac4566f7538"),
      data: Signet.Util.decode_hex!("0x0000000000000000000000000000000000000000000000000000000000000000"),
      topics: [
        Signet.Util.decode_hex!("0xe0d20d95fbbe7375f6edead77b5ce5c5b096e7dac85848c45c37a95eaf17fe62"),
        Signet.Util.decode_hex!("0x0000000000000000000000009d8ec03e9ddb71f04da9db1e38837aaac1782a97"),
        Signet.Util.decode_hex!("0x00000000000000000000000054f0a87eb5c8c8ba70243de1ac19e735b41b10a2"),
        Signet.Util.decode_hex!("0x0000000000000000000000000000000000000000000000000000000000000000")
      ]
    },
    %Signet.Receipt.Log{
      log_index: 2,
      block_number: 10493428,
      block_hash: Signet.Util.decode_hex!("0x4bc3c26b1a599ced9876d9bf9a17c9bd58ec8b71a68e75335de7f2820e9336ca"),
      transaction_hash: Signet.Util.decode_hex!("0xf9e69be4f1ae524854e14dc820c519d8f2b86e52c60e54448abf920d22fb6fe2"),
      transaction_index: 0,
      address: Signet.Util.decode_hex!("0xcb372382aa9a9e6f926714f4305afac4566f7538"),
      data: <<>>,
      topics: [
        Signet.Util.decode_hex!("0x0000000000000000000000000000000000000000000000000000000000000055")
      ]
    }
  ],
  logs_bloom: Signet.Util.decode_hex!("0x00800000000000000000000400000000000000000000000000000000000000000000000000000000000000000000002000200040000000000000000200001000000000000000000000000000000000000000000000000000000000000010000000008000020000004000000200000800000000000000000000220000000000000000000000000800000000000400000000000000000000000000000000000000000000040000000000008000008000000000000000000000000000000004000000800000000000004000000000000000000000000000000004080000000020000000000000000080000000000000000000000000000000000000000000000000"),
  type: 0,
  status: 1
}}


iex> Signet.RPC.get_trx_receipt(<<1::256>>)
{:error, "failed to decode result"}

iex> Signet.RPC.get_trx_receipt(<<2::256>>)
{:ok, nil}
Link to this function

prepare_trx(contract, call_data, opts \\ [])

View Source

Helper function to work with other Signet modules to get a nonce, sign a transction, and prepare it to be submitted on-chain.

If you need higher-level functionality, like manual nonce tracking, you may want to use the more granular function calls.

Options:

  • gas_price - Set the base gas for the transaction, overrides all other gas prices listed below (default nil) [note: only compatible with V1 transaction]
  • base_fee - Set the base price for the transaction, if nil, will use base gas price from eth_gasPrice call (default nil) [note: only compatible with V2 transactions]
  • base_fee_buffer - Buffer for the gas price when estimating gas (default: 1.2 = 120%) [note: only compatible with V2 transactions]
  • priority_fee - Additional gas to send as a priority fee. (default: {0, :gwei}) [note: only compatible with V2 transactions]
  • gas_limit - Set the gas limit for the transaction (default: calls eth_estimateGas)
  • gas_buffer - Buffer if estimating gas limit (default: 1.5 = 150%)
  • value - Value to provide with transaction in wei (default: 0)
  • nonce - Nonce to send with transaction. (default: lookup via eth_transactionCount)
  • verify - Verify the function is likely to succeed (default: true)
  • trx_type - :v1 for V1 (pre-EIP-1559 transactions), :v2 for V2 (EIP-1559) transactions, and nil for auto-detect.

Note: if we don't verify, then estimateGas will likely fail if the transaction were to fail.

    To prevent this, `gas_limit` should always be supplied when `verify` is set to false.

Examples

iex> signer_proc = Signet.Test.Signer.start_signer()
iex> {:ok, trx} = Signet.RPC.prepare_trx(<<1::160>>, {"baz(uint,address)", [50, :binary.decode_unsigned(<<1::160>>)]}, gas_price: {50, :gwei}, nonce: 10, value: 0, signer: signer_proc)
iex> %{trx|v: nil, r: nil, s: nil}
%Signet.Transaction.V1{
  nonce: 10,
  gas_price: 50000000000,
  gas_limit: 20,
  to: <<1::160>>,
  value: 0,
  data: <<162, 145, 173, 214, 0::248, 50, 0::248, 1>>
}

iex> signer_proc = Signet.Test.Signer.start_signer()
iex> {:ok, trx} = Signet.RPC.prepare_trx(<<1::160>>, {"baz(uint,address)", [50, <<1::160>> |> :binary.decode_unsigned]}, gas_price: {50, :gwei}, gas_limit: 100_000, value: 0, signer: signer_proc)
iex> %{trx|v: nil, r: nil, s: nil}
%Signet.Transaction.V1{
  nonce: 4,
  gas_price: 50000000000,
  gas_limit: 100000,
  to: <<1::160>>,
  value: 0,
  data: <<162, 145, 173, 214, 0::248, 50, 0::248, 1>>
}

iex> signer_proc = Signet.Test.Signer.start_signer()
iex> {:ok, trx} = Signet.RPC.prepare_trx(<<1::160>>, {"baz(uint,address)", [50, <<1::160>> |> :binary.decode_unsigned]}, gas_price: {50, :gwei}, gas_limit: 100_000, value: 0, nonce: 10, signer: signer_proc)
iex> %{trx|v: nil, r: nil, s: nil}
%Signet.Transaction.V1{
  nonce: 10,
  gas_price: 50000000000,
  gas_limit: 100000,
  to: <<1::160>>,
  value: 0,
  data: <<162, 145, 173, 214, 0::248, 50, 0::248, 1>>
}

iex> signer_proc = Signet.Test.Signer.start_signer()
iex> Signet.RPC.prepare_trx(<<10::160>>, {"baz(uint,address)", [50, <<1::160>> |> :binary.decode_unsigned]}, gas_price: {50, :gwei}, gas_limit: 100_000, value: 0, nonce: 10, signer: signer_proc)
{:error, "error 3: execution reverted (0x3d738b2e)"}

iex> # Set gas price directly
iex> signer_proc = Signet.Test.Signer.start_signer()
iex> {:ok, trx} = Signet.RPC.prepare_trx(<<10::160>>, {"baz(uint,address)", [50, <<1::160>> |> :binary.decode_unsigned]}, gas_price: {50, :gwei}, gas_limit: 100_000, value: 0, nonce: 10, verify: false, signer: signer_proc)
iex> %{trx|v: nil, r: nil, s: nil}
%Signet.Transaction.V1{
  nonce: 10,
  gas_price: 50000000000,
  gas_limit: 100000,
  to: <<10::160>>,
  value: 0,
  data: <<162, 145, 173, 214, 0::248, 50, 0::248, 1>>
}

iex> # Default gas price v1
iex> signer_proc = Signet.Test.Signer.start_signer()
iex> {:ok, trx} = Signet.RPC.prepare_trx(<<10::160>>, {"baz(uint,address)", [50, <<1::160>> |> :binary.decode_unsigned]}, gas_limit: 100_000, trx_type: :v1, value: 0, nonce: 10, verify: false, signer: signer_proc)
iex> %{trx|v: nil, r: nil, s: nil}
%Signet.Transaction.V1{
  nonce: 10,
  gas_price: 1200000000,
  gas_limit: 100000,
  to: <<10::160>>,
  value: 0,
  data: <<162, 145, 173, 214, 0::248, 50, 0::248, 1>>
}

iex> # Default gas price v2
iex> signer_proc = Signet.Test.Signer.start_signer()
iex> {:ok, trx} = Signet.RPC.prepare_trx(<<10::160>>, {"baz(uint,address)", [50, <<1::160>> |> :binary.decode_unsigned]}, gas_limit: 100_000, trx_type: :v2, value: 0, nonce: 10, verify: false, signer: signer_proc)
iex> %{trx|signature_y_parity: nil, signature_r: nil, signature_s: nil}
%Signet.Transaction.V2{
  chain_id: 5,
  nonce: 10,
  gas_limit: 100000,
  destination: <<10::160>>,
  amount: 0,
  max_fee_per_gas: 1200000000,
  max_priority_fee_per_gas: 0,
  data: <<162, 145, 173, 214, 0::248, 50, 0::248, 1>>,
  access_list: []
}

iex> # Default gas price (trx_type: nil)
iex> signer_proc = Signet.Test.Signer.start_signer()
iex> {:ok, trx} = Signet.RPC.prepare_trx(<<10::160>>, {"baz(uint,address)", [50, <<1::160>> |> :binary.decode_unsigned]}, gas_limit: 100_000, value: 0, nonce: 10, verify: false, signer: signer_proc)
iex> %{trx|signature_y_parity: nil, signature_r: nil, signature_s: nil}
%Signet.Transaction.V2{
  chain_id: 5,
  nonce: 10,
  gas_limit: 100000,
  destination: <<10::160>>,
  amount: 0,
  max_fee_per_gas: 1200000000,
  max_priority_fee_per_gas: 0,
  data: <<162, 145, 173, 214, 0::248, 50, 0::248, 1>>,
  access_list: []
}

iex> # Set priority fee (v2)
iex> signer_proc = Signet.Test.Signer.start_signer()
iex> {:ok, trx} = Signet.RPC.prepare_trx(<<10::160>>, {"baz(uint,address)", [50, <<1::160>> |> :binary.decode_unsigned]}, priority_fee: {3, :gwei}, gas_limit: 100_000, value: 0, nonce: 10, verify: false, signer: signer_proc)
iex> %{trx|signature_y_parity: nil, signature_r: nil, signature_s: nil}
%Signet.Transaction.V2{
  chain_id: 5,
  nonce: 10,
  gas_limit: 100000,
  destination: <<10::160>>,
  amount: 0,
  max_fee_per_gas: 1200000000,
  max_priority_fee_per_gas: 3000000000,
  data: <<162, 145, 173, 214, 0::248, 50, 0::248, 1>>,
  access_list: []
}

iex> # Set base fee and priority fee (v2)
iex> signer_proc = Signet.Test.Signer.start_signer()
iex> {:ok, trx} = Signet.RPC.prepare_trx(<<10::160>>, {"baz(uint,address)", [50, <<1::160>> |> :binary.decode_unsigned]}, base_fee: {1, :gwei}, priority_fee: {3, :gwei}, gas_limit: 100_000, value: 0, nonce: 10, verify: false, signer: signer_proc)
iex> %{trx|signature_y_parity: nil, signature_r: nil, signature_s: nil}
%Signet.Transaction.V2{
  chain_id: 5,
  nonce: 10,
  gas_limit: 100000,
  destination: <<10::160>>,
  amount: 0,
  max_fee_per_gas: 1000000000,
  max_priority_fee_per_gas: 3000000000,
  data: <<162, 145, 173, 214, 0::248, 50, 0::248, 1>>,
  access_list: []
}
Link to this function

send_rpc(method, params, opts \\ [])

View Source

Simple RPC client for a JSON-RPC Ethereum node.

Examples

iex> Signet.RPC.send_rpc("net_version", [])
{:ok, "3"}

iex> Signet.RPC.send_rpc("get_balance", ["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"], ethereum_node: "http://example.com")
{:ok, "0x0234c8a3397aab58"}
Link to this function

send_trx(trx, opts \\ [])

View Source

RPC call to send a raw transaction.

Examples

iex> signer_proc = Signet.Test.Signer.start_signer()
iex> {:ok, signed_trx} = Signet.Transaction.build_signed_trx(<<1::160>>, 5, {"baz(uint,address)", [50, :binary.decode_unsigned(<<1::160>>)]}, {50, :gwei}, 100_000, 0, chain_id: :goerli, signer: signer_proc)
iex> {:ok, trx_id} = Signet.RPC.send_trx(signed_trx)
iex> <<nonce::integer-size(8), gas_price::integer-size(64), gas_limit::integer-size(24), to::binary>> = trx_id
iex> {nonce, gas_price, gas_limit, to}
{5, 50000000000, 100000, <<1::160>>}

iex> signer_proc = Signet.Test.Signer.start_signer()
iex> {:ok, signed_trx} = Signet.Transaction.build_signed_trx_v2(<<1::160>>, 5, {"baz(uint,address)", [50, :binary.decode_unsigned(<<1::160>>)]}, {50, :gwei}, {10, :gwei}, 100_000, 0, [], chain_id: :goerli, signer: signer_proc)
iex> {:ok, trx_id} = Signet.RPC.send_trx(signed_trx)
iex> <<nonce::integer-size(8), max_priority_fee_per_gas::integer-size(64), max_fee_per_gas::integer-size(64), gas_limit::integer-size(24), to::binary>> = trx_id
iex> {nonce, max_priority_fee_per_gas, max_fee_per_gas, gas_limit, to}
{5, 50000000000, 10000000000, 100000, <<1::160>>}
Link to this function

trace_trx(trx_id, opts \\ [])

View Source

RPC call to get a transaction receipt

Examples

iex> Signet.RPC.trace_trx("0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5")
{:ok,
  [
  %Signet.Trace{
    action: %Signet.Trace.Action{
      call_type: "call",
      from: Signet.Util.decode_hex!("0x83806d539d4ea1c140489a06660319c9a303f874"),
      gas: 0x01a1f8,
      input: <<>>,
      to: Signet.Util.decode_hex!("0x1c39ba39e4735cb65978d4db400ddd70a72dc750"),
      value: 0x7a16c911b4d00000,
    },
    block_hash: Signet.Util.decode_hex!("0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add"),
    block_number: 3068185,
    gas_used: 0x2982,
    output: <<>>,
    subtraces: 2,
    trace_address: [Signet.Util.decode_hex!("0x1c39ba39e4735cb65978d4db400ddd70a72dc750")],
    transaction_hash: Signet.Util.decode_hex!("0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3"),
    transaction_position: 2,
    type: "call"
  },
  %Signet.Trace{
    action: %Signet.Trace.Action{
      call_type: "call",
      from: Signet.Util.decode_hex!("0x83806d539d4ea1c140489a06660319c9a303f874"),
      gas: 0x01a1f8,
      input: <<>>,
      to: Signet.Util.decode_hex!("0x1c39ba39e4735cb65978d4db400ddd70a72dc750"),
      value: 0x7a16c911b4d00000,
    },
    block_hash: Signet.Util.decode_hex!("0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add"),
    block_number: 3068186,
    gas_used: 0x2982,
    output: <<>>,
    subtraces: 2,
    trace_address: [Signet.Util.decode_hex!("0x1c39ba39e4735cb65978d4db400ddd70a72dc750")],
    transaction_hash: Signet.Util.decode_hex!("0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3"),
    transaction_position: 2,
    type: "call"
  }
]}