Skip to content

bigchiano/abiencoder

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

54 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ABI Encoder

https://abi.hashex.org

Description

Free ABI encoder online service that allows you to encode your Solidity contract’s functions and constructor arguments.

ABI itself is the description of the code interface. It’s a way for the contracts to interact within an ecosystem as well as contract-to-contract.

Smart contract ABI parsing is required for verifying the contract on Etherscan or making a transaction to call a method, for example for a Timelock contract. For most actions regarding this code, you would require a special tool, and the arguments have to be encoded in a specific way. HashEx tool does it automatically, free, and doesn’t involve downloading any extra applications.

Code itself is used in the byte format, so it’s harder to decode it correctly. For easy interactions with said code, HashEx has created its ABI decoder. An additional tool allows you to manually enter the values for the parameters.

Supported types

  • uint8..256
  • uint[]8..256
  • bytes8..32
  • bytes[]8..32
  • address
  • address[]
  • string
  • bool
  • bool[]
  • tuple (supports Struct from ABI)

Feel free to open PR to add new types.

How to use

Manually enter

  1. Enter signature of function (Example: transferFrom(adress, uint)) manually with selecting "your function" option or use the "constructor" option.
  2. Add arguments, select the correct types.
  3. Fill the arguments.
  4. Encoded data will appear in the text area under the function. Click "Copy" button and paste it where ever you want.

image

Using ABI autoparse

  1. Enter your contract ABI into the text field and click "Parse" button.
  2. Select the function or constructor from the parsed list.
  3. Fill the arguments.
  4. Encoded data will appear in the text area under the function. Click "Copy" button and paste it where ever you want.

image

How to encode struct arguments

Encode struct argument with existing ABI

  1. Enter your contract ABI into the text field and click "Parse" button.
  2. Select the function or constructor from the parsed list which has struct argument.
  3. Enter struct value according to example. Use Struct description under input as a hint.
  4. Encoded data will appear in the text area under the function. Click "Copy" button and paste it where ever you want.

image

Encode struct argument without existing ABI

  1. Describe your function or constructor using ABI template.

Function example:

    contract MyCustomContract {
        struct MyCustomStruct {
            uint256 number;
            address to;
        }
        constructor(MyCustomStruct memory _myCustomStruct) {
            // some logic
        }
        function myCustomFunction(MyCustomStruct memory _myCustomStruct) {
            // some logic
        }
    }

ABI example:

    [{
        "type": "constructor",
        "name": "",
        "inputs": [{
            "components": [{ 
                "type": "uint256",
                "name": "number"
            },{
                "type": "string",
                "name": "note"
            }],
            "internalType": "struct MyCustomContract.MyCustomStruct",
            "type": "tuple",
            "name": "_myCustomStruct"
        }]
    },{
        "type": "function",
        "name": "myCustomFunction",
        "inputs": [{
            "components": [{ 
                "type": "uint256",
                "name": "number"
            },{
                "type": "string",
                "name": "note"
            }],
            "internalType": "struct MyCustomContract.MyCustomStruct",
            "name": "_myCustomStruct",
            "type": "tuple"
        }]
    }]
"components": [...],    // `components` field is for Struct fields description
"type": "tuple",        // this type means you want to use Struct as argument

then follow the steps as if you have ABI to parse.

How to run

Install dependencies

npm install or yarn

Start project

npm start or yarn start

…and open http://localhost:3000 in your web browser.

Contributing

The site is powered by CRA(Create React App) using React.js and ethers.js.

  1. Fork the repo on GitHub
  2. Clone the project to your own machine
  3. Commit changes to your own branch
  4. Push your work back up to your fork
  5. Submit a Pull request so that we can review your changes

NOTE: Be sure to merge the latest from "upstream" before making a pull request!

Licenses

MIT

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 98.0%
  • CSS 1.2%
  • Other 0.8%