WEMIX 3.0

https://docs.wemix.com/en
Admin
WEMIX 3.0 is a high-performance blockchain platform built with Go-Ethereum that provides a consensus...
Tokens:92,433
Snippets:690
Trust Score:9.2
Update:4 months ago
Show doc for...
Tokens:
Raw
### Install Node.js, web3.js, and ethereumjs-util.js

Source: https://docs.wemix.com/en/tutorial/use-fee-delegation

Before using the fee delegation modules, ensure Node.js is installed and then install the required JavaScript libraries using npm.

```bash
npm install web3; npm install ethereumjs-util;
```

--------------------------------

### Dynamic Documentation Query Example

Source: https://docs.wemix.com/en/dapp-developer/api-reference/event-logs-apis

To get additional information not explicitly present on the page, perform an HTTP GET request with the 'ask' query parameter. The question should be specific and self-contained.

```http
GET https://docs.wemix.com/en/dapp-developer/api-reference/event-logs-apis.md?ask=<question>
```

--------------------------------

### Install Truffle

Source: https://docs.wemix.com/en/dapp-developer/smart-contract/sample-contracts

Install Truffle globally using NPM. Ensure Node.js and NPM are installed.

```bash
$ npm install --g truffle
```

--------------------------------

### Start gwemix Node

Source: https://docs.wemix.com/en/install-and-operation/block-producer-node/install-guide

Executes the start script for the WEMIX node. Ensure the GWEMIX_HOME environment variable is set correctly.

```bash
$GWEMIX_HOME/bin/gwemix.sh start
```

--------------------------------

### Install Build Dependencies (Ubuntu 22.04 LTS)

Source: https://docs.wemix.com/en/install-and-operation/block-producer-node/install-guide

Installs essential build tools and Go for compiling the WEMIX node on Ubuntu 22.04 LTS.

```bash
sudo apt-get update
sudo apt-get install -y build-essential golang
```

--------------------------------

### Create and Initialize Hardhat Project

Source: https://docs.wemix.com/en/tutorial/create-smart-contract/hardhat

Steps to create a new directory, install Hardhat, and initialize a new project using the Hardhat command-line interface. This includes selecting project type and installing dependencies.

```bash
$ mkdir greeter
$ cd greeter

$ npm install --save-dev hardhat

$ npx hardhat
888    888                      888 888               888
888    888                      888 888               888
888    888                      888 888               888
8888888888  8888b.  888d888 .d88888 88888b.   8888b.  888888
888    888     "88b 888P"  d88" 888 888 "88b     "88b 888
888    888 .d888888 888    888  888 888  888 .d888888 888
888    888 888  888 888    Y88b 888 888  888 888  888 Y88b.
888    888 "Y888888 888     "Y88888 888  888 "Y888888  "Y888

👷 Welcome to Hardhat v2.13.0 👷‍

✔ What do you want to do? · Create a JavaScript project
✔ Hardhat project root: · /Users/trident/Projects/Solidity/hardhat-test
✔ Do you want to add a .gitignore? (Y/n) · y
✔ Do you want to install this sample project's dependencies with npm (hardhat @nomicfoundation/hardhat-toolbox)? (Y/n) · y
```

--------------------------------

### Install Go Version 1.18.4 (Ubuntu 20.04/18.04 LTS)

Source: https://docs.wemix.com/en/install-and-operation/block-producer-node/install-guide

Downloads, installs, and configures Go version 1.18.4, which is required for building the WEMIX node on specific Ubuntu versions.

```bash
wget https://go.dev/dl/go1.18.4.linux-amd64.tar.gz
sudo rm -rf /usr/local/go && sudo tar -C /usr/local -xzf go1.18.4.linux-amd64.tar.gz
export PATH=$PATH:/usr/local/go/bin
source $HOME/.profile
```

--------------------------------

### Start WEMIX3.0 Node

Source: https://docs.wemix.com/en/install-and-operation/operation-guide

Use this command to start the built 'gwemix' node using the 'gwemix.sh' script. Log files are automatically saved in the '{data_folder}/log' directory.

```bash
{data_directory}/bin/gwemix.sh start
```

--------------------------------

### Install Build Dependencies (Ubuntu 20.04/18.04 LTS)

Source: https://docs.wemix.com/en/install-and-operation/block-producer-node/install-guide

Installs essential build tools for compiling the WEMIX node on older Ubuntu LTS versions.

```bash
sudo apt-get update
sudo apt-get install -y build-essential
```

--------------------------------

### Example: Execute Total Supply API (Testnet)

Source: https://docs.wemix.com/en/tutorial/erc-20-token/check-erc-20-token-api

This is an example of a Testnet ERC-20 token total supply API query. It demonstrates how to format the URI with a specific contract address.

```HTTP
https://explorerapi.test.wemix.com/v1/tokens/0x316E2e2DB3fb28e663F2F59899f98D5b925F7E53/total-supply
```

--------------------------------

### Mint Tokens Example

Source: https://docs.wemix.com/en/dapp-developer/api-reference/contract-apis

Example of minting tokens. This example mints 100 tokens to the message sender.

```Solidity
// Mint 100 tokens to msg.sender
// Similar to how
// 1 dollar = 100 cents
// 1 token = 1 * (10 ** decimals)
_mint(msg.sender, 99999999 * 10**uint(decimals()));
```

--------------------------------

### Burn Tokens Example

Source: https://docs.wemix.com/en/dapp-developer/api-reference/contract-apis

Example of burning tokens. This example burns a specified amount of tokens from an account.

```Solidity
function burn(address account, uint256 amount) public virtual returns (bool) {

    _burn(account, amount * 10**uint(decimals()));

    return true;
}
```

--------------------------------

### Counter Smart Contract Example

Source: https://docs.wemix.com/en/dapp-developer/smart-contract/sample-contracts

A simple Solidity contract demonstrating increment, decrement, and get functions for a counter variable.

```solidity
pragma solidity ^0.8.0;

contract Counter {
    uint256 count;
    
    constructor(uint256 _count) {
        count = _count;
    }
    
    function get() public view returns (uint256) {
        return count;
    }
    
    function inc() public {
        count += 1;
    }
    
    function dec() public {
        count -= 1;
    }
}
```

--------------------------------

### Query Documentation with GET Request

Source: https://docs.wemix.com/en/tutorial/create-smart-contract

To get additional information not directly available on a page, perform an HTTP GET request to the current page URL with the 'ask' query parameter. The question should be specific and in natural language.

```bash
GET https://docs.wemix.com/en/tutorial/create-smart-contract.md?ask=<question>
```

--------------------------------

### Querying Documentation with Remix

Source: https://docs.wemix.com/en/tutorial/create-smart-contract/remix

Demonstrates how to dynamically query documentation for additional information using an HTTP GET request with the 'ask' query parameter.

```http
GET https://docs.wemix.com/en/tutorial/create-smart-contract/remix.md?ask=<question>
```

--------------------------------

### Install gwemix Binary (Ubuntu 22.04 LTS)

Source: https://docs.wemix.com/en/install-and-operation/block-producer-node/install-guide

Copies the compiled gwemix binary and associated scripts to the specified GWEMIX_HOME directory and extracts the archive.

```bash
GWEMIX_HOME='/opt/gwemix'
sudo mkdir -p $GWEMIX_HOME
sudo chown $USER:$USER $GWEMIX_HOME
cp build/gwemix.tar.gz $GWEMIX_HOME/
cd $GWEMIX_HOME
tar xvzf gwemix.tar.gz
```

--------------------------------

### Example Token Name and Symbol

Source: https://docs.wemix.com/en/tutorial/erc-721-token/write-erc-721-contract

This example demonstrates how to set the token name to 'WMNFT' and the symbol to 'NFT' within the ERC-721 contract's constructor.

```solidity
constructor() public ERC721("WMNFT", "NFT") {}
```

--------------------------------

### Query Documentation via HTTP GET

Source: https://docs.wemix.com/en/tutorial/create-smart-contract/hardhat

Perform an HTTP GET request on a documentation URL with the 'ask' query parameter to ask a question. The response will contain a direct answer and relevant excerpts.

```http
GET https://docs.wemix.com/en/tutorial/create-smart-contract/hardhat.md?ask=<question>
```

--------------------------------

### Request Sample for Mined Blocks by Address

Source: https://docs.wemix.com/en/dapp-developer/api-reference/account-apis

Example of a GET request to retrieve blocks mined by a specific address. Includes the API endpoint and an example API key.

```http
GET https://explorerapi.test.wemix.com/v1/accounts/0xf04f49b134996023e980022502581c7278f3191a/mined-blocks
api-key: 1ba5e446edf1997f67b51bf9e60b3fbba6fa1bf84301115292805d7e24f43539
```

--------------------------------

### Ask a Question via GET Request

Source: https://docs.wemix.com/en

Perform an HTTP GET request to the documentation index with the 'ask' parameter to get a specific answer to a question. The question should be self-contained and in natural language.

```http
GET https://docs.wemix.com/about.md?ask=<question>
```

--------------------------------

### Query Documentation via HTTP GET

Source: https://docs.wemix.com/en/install-and-operation

Use this method to dynamically query the documentation by asking a question. Perform an HTTP GET request on the current page URL with the 'ask' query parameter.

```HTTP
GET https://docs.wemix.com/en/install-and-operation.md?ask=<question>
```

--------------------------------

### Query Documentation Dynamically

Source: https://docs.wemix.com/en/quick-start/start-node/use-binary/command-line-option

To get more information not present on the current page, make an HTTP GET request to the page URL with the 'ask' query parameter. The question should be specific and in natural language.

```bash
GET https://docs.wemix.com/en/quick-start/start-node/use-binary/command-line-option.md?ask=<question>
```

--------------------------------

### Simple Counter Smart Contract

Source: https://docs.wemix.com/en/dapp-developer/smart-contract/solidity

A basic Solidity contract demonstrating state variables, a constructor, and functions to get, increment, and decrement a counter. Use this as a starting point for simple state management contracts.

```solidity
// SPDX-License-Identifier: MIT

pragma solidity ^0.8.11;

contract Counter {
    uint256 count;
    
    constructor(uint256 _count) {
        count = _count;
    }
    
    function get() public view returns (uint256) {
        return count;
    }
    
    function inc() public {
        count += 1;
    }
    
    function dec() public {
        count -= 1;
    }
}
```

--------------------------------

### Example: Check Testnet ERC-721 Token Inventory

Source: https://docs.wemix.com/en/tutorial/erc-721-token/check-erc-721-token-api

An example of a complete URI to check the inventory for a specific ERC-721 token contract address on the WEMIX3.0 Testnet.

```HTTP
https://explorerapi.test.wemix.com/v1/tokens/0x3DDeE3714160A49573285473f40452cec67114B4/inventory
```

--------------------------------

### Connect via RPC

Source: https://docs.wemix.com/en/quick-start/connect-node

Use this command to connect to the locally installed gwemix RPC web server.

```bash
gwemix attach rpc:http://localhost:8588
```

--------------------------------

### Querying Documentation Dynamically

Source: https://docs.wemix.com/en/dapp-developer/json-rpc

To get more information not directly available on the page, make an HTTP GET request to the page URL with the 'ask' query parameter. The question should be specific and in natural language.

```HTTP
GET https://docs.wemix.com/en/dapp-developer/json-rpc.md?ask=<question>
```

--------------------------------

### GET Account Transactions Sample Request

Source: https://docs.wemix.com/en/dapp-developer/api-reference/account-apis

This sample demonstrates how to retrieve transactions for a specific account using the GET method. Ensure you include the 'api-key' in the header.

```http
GET https://explorerapi.wemix.com/v1/accounts/0xBbAB376Fd9c3a0f5ef1D2114c8dd1512FD858ee2/transactions
api-key: 1ba5e446edf1997f67b51bf9e60b3fbba6fa1bf84301115292805d7e24f43539
```

--------------------------------

### Install RocksDB Dependencies (Ubuntu 22.04 LTS)

Source: https://docs.wemix.com/en/install-and-operation/block-producer-node/install-guide

Installs RocksDB specific dependencies required for building the WEMIX node with RocksDB support on Ubuntu 22.04 LTS.

```bash
sudo apt-get install -y snappy-dev libjemalloc-dev
cd /usr/lib/x86_64-linux-gnu/
sudo ln -sf libjemalloc.so.2 libjemalloc.so.1
```

--------------------------------

### Truffle Migration with Network Configuration

Source: https://docs.wemix.com/en/dapp-developer/smart-contract/sample-contracts

Example output of running a Truffle migration on the WEMIX Testnet, including compilation status, network details, and deployment costs for initial and contract migrations.

```bash
❯ truffle migrate --reset --network wemix_testnet

Compiling your contracts...
===========================
> Everything is up to date, there is nothing to compile.


Starting migrations...
======================
> Network name:    'wemix_testnet'
> Network id:      1112
> Block gas limit: 105000000 (0x6422c40)


1_initial_migration.js
======================

   Replacing 'Migrations'
   ----------------------
   > transaction hash:    0x8f57dc573afbf1e33b75b2f05282aac9152be70cee292c31c94877397cf27d82
   > Blocks: 0            Seconds: 0
   > contract address:    0x09C38aaf3AF7Dba9Cc2B755d75Acccf4A5b7bECC
   > block number:        428504
   > block timestamp:     1658480854
   > account:             0x435AaB89A2878102fDf894dA3e5F3b4454FF9772
   > balance:             9.926666599999266666
   > gas used:            250142 (0x3d11e)
   > gas price:           100.000000001 gwei
   > value sent:          0 ETH
   > total cost:          0.025014200000250142 ETH

   > Saving migration to chain.
   > Saving artifacts
   -------------------------------------
   > Total cost:     0.025014200000250142 ETH


2_deploy_contracts.js
=====================

   Deploying 'Counter'
   -------------------
   > transaction hash:    0x893fcc06e298b95ff145c90311c5d36a3f8c511470e73a753d13195ea9dae051
   > Blocks: 0            Seconds: 0
   > contract address:    0x76F3A4DFD8741E765Bf27Cd0BaaE26f64c192765
   > block number:        428508
   > block timestamp:     1658480857
   > account:             0x435AaB89A2878102fDf894dA3e5F3b4454FF9772
   > balance:             9.904089499999040895
   > gas used:            179858 (0x2be92)
   > gas price:           100.000000001 gwei
   > value sent:          0 ETH
   > total cost:          0.017985800000179858 ETH

   > Saving migration to chain.
   > Saving artifacts
   -------------------------------------
   > Total cost:     0.017985800000179858 ETH

Summary
=======
> Total deployments:   2
> Final cost:          0.04300000000043 ETH

```

--------------------------------

### Query Documentation with 'ask' Parameter

Source: https://docs.wemix.com/en/tutorial/receive-test-coin

To get more information not directly available on the page, make an HTTP GET request to the page URL with the 'ask' query parameter. This is useful for clarifications or retrieving related documentation sections.

```HTTP
GET https://docs.wemix.com/en/tutorial/receive-test-coin.md?ask=<question>
```

--------------------------------

### Query Documentation Dynamically

Source: https://docs.wemix.com/en/dapp-developer

To get additional information not directly present on the page, perform an HTTP GET request to the current page URL with the `ask` query parameter. The question should be specific and in natural language.

```http
GET https://docs.wemix.com/en/dapp-developer.md?ask=<question>
```

--------------------------------

### Node Settings Configuration

Source: https://docs.wemix.com/en/quick-start/connect-node

Configure node execution options by creating a .rc file in the data folder. This example shows how to set the port, enable discovery mode, use Testnet, set sync mode, and add custom options.

```bash
PORT=8588
DISCOVER=1        # 1 for enable discovery mode, 0 for disable discovery mode
TESTNET=1         # 1 for Testnet or remove this line for Mainnet
SYNC_MODE=full
GWEMIX_OPTS="--rpc.allow-unprotected-txs"
```

--------------------------------

### Install Rocksdb Dependency for Ubuntu

Source: https://docs.wemix.com/en/install-and-operation/block-producer-node/install-guide

Installs the libjemalloc1 package required for Rocksdb on Ubuntu 18.04 LTS. This is a prerequisite for certain configurations.

```bash
sudo apt-get isntall libjemalloc1
```

--------------------------------

### Query Documentation with `ask` Parameter

Source: https://docs.wemix.com/en/dapp-developer/api-reference

To get specific information not directly on a page, perform an HTTP GET request to the page URL with the `ask` query parameter. The question should be specific and in natural language.

```HTTP
GET https://docs.wemix.com/en/dapp-developer/api-reference.md?ask=<question>
```

--------------------------------

### Connect via IPC

Source: https://docs.wemix.com/en/quick-start/connect-node

Use this command to connect to the locally installed gwemix IPC file.

```bash
gwemix attach {data_folder}/gwemix.ipc
```

--------------------------------

### Install RocksDB Dependencies (Ubuntu 20.04/18.04 LTS)

Source: https://docs.wemix.com/en/install-and-operation/block-producer-node/install-guide

Installs RocksDB specific dependencies required for building the WEMIX node with RocksDB support on older Ubuntu LTS versions.

```bash
sudo apt-get install -y libsnappy-dev libjemalloc-dev
cd /usr/lib/x86_64-linux-gnu/
sudo ln -sf libjemalloc.so.2 libjemalloc.so.1
```

--------------------------------

### Build gwemix with RocksDB (Ubuntu 22.04 LTS)

Source: https://docs.wemix.com/en/install-and-operation/block-producer-node/install-guide

Compiles the gwemix binary using RocksDB as the database backend. Ensure RocksDB dependencies are installed.

```bash
make
```

--------------------------------

### Query Documentation with 'ask' Parameter

Source: https://docs.wemix.com/en/tutorial/erc-20-token

Perform an HTTP GET request to query documentation dynamically. Use this when the answer is not explicitly present, for clarification, or to retrieve related sections.

```HTTP
GET https://docs.wemix.com/en/tutorial/erc-20-token.md?ask=<question>
```

--------------------------------

### Define Greeter Contract with Constructor and Methods

Source: https://docs.wemix.com/en/tutorial/create-smart-contract/truffle

This is an example of a 'Greeter' smart contract that accepts an initial greeting in its constructor and provides methods to retrieve and set the greeting.

```solidity
// SPDX-License-Identifier: MIT
pragma solidity >=0.4.22 <0.9.0;

contract Greeter {
    string private greeting;

    constructor(string memory _greeting) public {
        greeting = _greeting;
    }

    function greet() public view returns (string memory) {
        return greeting;
    }

    function setGreeting(string memory _greeting) public {
        greeting = _greeting;
    }
}
```

--------------------------------

### Create a Simple Contract Template

Source: https://docs.wemix.com/en/tutorial/create-smart-contract/truffle

Use the 'truffle create contract' command to generate a basic smart contract file. This is a starting point for your contract logic.

```solidity
// SPDX-License-Identifier: MIT
pragma solidity >=0.4.22 <0.9.0;

contract Greeter {
  constructor() public {
  }
}
```

--------------------------------

### Query Documentation Dynamically

Source: https://docs.wemix.com/en/faq

To get information not directly available on a page, make an HTTP GET request with the 'ask' query parameter. The question should be specific and in natural language. This is useful for clarifications or retrieving related sections.

```http
GET https://docs.wemix.com/en/faq.md?ask=<question>
```

--------------------------------

### Querying Documentation with 'ask' Parameter

Source: https://docs.wemix.com/en/dapp-developer/smart-contract

Use this GET request to query the documentation dynamically for information not explicitly present on the page. The question should be specific and self-contained.

```http
GET https://docs.wemix.com/en/dapp-developer/smart-contract.md?ask=<question>
```

--------------------------------

### Restart WEMIX3.0 Node

Source: https://docs.wemix.com/en/install-and-operation/operation-guide

Execute this command to stop and then start the 'gwemix' node.

```bash
{data_directory}/bin/gwemix.sh restart
```

--------------------------------

### Query Documentation Dynamically

Source: https://docs.wemix.com/en/design

Use this HTTP GET request to query the documentation dynamically with a specific question. The question should be self-contained and in natural language. The response includes a direct answer and relevant excerpts.

```http
GET https://docs.wemix.com/en/design.md?ask=<question>
```

--------------------------------

### Token Inventory Response Sample

Source: https://docs.wemix.com/en/dapp-developer/api-reference/tokens-apis

Example of a successful response when querying a token's inventory. Includes count, data list, token name, and symbol.

```json
{
    "status": "200",
    "message": "success",
    "results": {
        "count": "65",
        "data": [
            {
                "holder_address": "0xb0fb83eed8de308d0a076b9763d47a0e1f5d3b7d",
                "token_id": "51",
                "token_uri": "ipfs://bafyreifytod4coyoolbxj6f4nm6hluwqcrhy4vi5hxl5nzpeydodnowh7u/metadata.json"
            },
           ...
        ],
        "token_name": "Tangled",
        "token_symbol": "TTPS"
    }
}
```

--------------------------------

### Get Balance Of

Source: https://docs.wemix.com/en/dapp-developer/api-reference/contract-apis

Returns the balance of a specific account.

```Solidity
function balanceOf(address account) public view virtual override returns (uint256) {
    return _balances[account];
}
```

--------------------------------

### ERC721 Token Response Sample

Source: https://docs.wemix.com/en/dapp-developer/api-reference/account-apis

Example of a successful response when retrieving ERC721 tokens for an account.

```JSON
{
    "status": "200",
    "message": "success",
    "results": {
        "count": "1",
        "data": [
            {
                "token_address": "0x62e1ad2a3a9ab55ba20bc4eb27fca655c41fdd88",
                "token_name": "Tangled",
                "token_symbol": "TTPS"
            }
        ]
    }
}
```

--------------------------------

### Request Sample for Internal Transactions

Source: https://docs.wemix.com/en/dapp-developer/api-reference/account-apis

This sample demonstrates a GET request to retrieve internal transactions for a specific address, including input data.

```http
GET https://explorerapi.wemix.com/v1/accounts/0xBEd789c6008F788a28fc222C83082D67033Daf7F/internal-transactions?input=true
api-key: 1ba5e446edf1997f67b51bf9e60b3fbba6fa1bf84301115292805d7e24f43539
```

--------------------------------

### ERC20 Token Account Balance Response

Source: https://docs.wemix.com/en/dapp-developer/api-reference/tokens-apis

Example response structure for the ERC20 token account balance query.

```JSON
{
    "status": "200",
    "message": "success",
    "results": {
        "data": {
            "balance": "82256898291758"
        }
    }
}
```

--------------------------------

### Querying Documentation via HTTP GET

Source: https://docs.wemix.com/en/install-and-operation/block-producer-node/firewall-setting

Use this method to dynamically query the documentation for specific information not explicitly present on the page. The response includes direct answers and relevant excerpts.

```bash
GET https://docs.wemix.com/en/install-and-operation/block-producer-node/firewall-setting.md?ask=<question>
```

--------------------------------

### Query Documentation Dynamically

Source: https://docs.wemix.com/en/design/roadmap

To retrieve specific information not directly present on a page, use an HTTP GET request with the 'ask' query parameter. This allows for dynamic querying of documentation content.

```HTTP
GET https://docs.wemix.com/en/design/roadmap.md?ask=<question>
```

--------------------------------

### Querying Event Logs

Source: https://docs.wemix.com/en/dapp-developer/api-reference/event-logs-apis

This section describes how to query event logs. It provides an example of a successful response structure.

```APIDOC
## GET /event-logs

### Description
Retrieves a list of event logs based on specified criteria.

### Method
GET

### Endpoint
/event-logs

### Query Parameters
(No specific query parameters are detailed in the source text, but the example response implies filtering capabilities.)

### Response
#### Success Response (200)
- **status** (string) - The status code of the response.
- **message** (string) - A message indicating the success or failure of the request.
- **results** (object) - Contains the count and data of the event logs.
  - **count** (string) - The total number of event logs found.
  - **data** (array) - An array of event log objects.
    - **timestamp** (string) - The timestamp of the event log.
    - **address** (string) - The address associated with the event log.
    - **data** (string) - The data payload of the event log.
    - **method** (string) - The method signature related to the event log.
    - **transaction_hash** (string) - The hash of the transaction.
    - **log_name** (null) - Placeholder for log name.
    - **log_abi** (null) - Placeholder for log ABI.
    - **address_type** (null) - Placeholder for address type.
    - **address_extra** (null) - Placeholder for extra address information.
    - **transaction_index** (string) - The index of the transaction.
    - **log_index** (string) - The index of the log.
    - **topics_count** (string) - The number of topics in the log.
    - **topic_0** (string) - The first topic of the log.
    - **topic_1** (null) - Placeholder for the second topic.
    - **topic_2** (null) - Placeholder for the third topic.
    - **topic_3** (null) - Placeholder for the fourth topic.

### Response Example
{
    "status": "200",
    "message": "success",
    "results": {
        "count": "214201",
        "data": [
            {
                "timestamp": "2023-08-10T10:11:05Z",
                "address": "0xead50432b7dcb8402208a65bc58951b8ccef9f08",
                "data": "0x0000000000000000000000009c2d3bb8565c2fc4335c1068dd0b6ca60fb4ecab",
                "method": "0xcdb6c50f",
                "transaction_hash": "0x2098c1cf552111f2a55ea022d832a9bd7a73c5661e62881334aab6e56353bced",
                "log_name": null,
                "log_abi": null,
                "address_type": null,
                "address_extra": null,
                "transaction_index": "0",
                "log_index": "0",
                "topics_count": "1",
                "topic_0": "0xcdb6c50fc95430ac4511195bb0a3cb943f34705415ec82960792a7545a6850bb",
                "topic_1": null,
                "topic_2": null,
                "topic_3": null
            },
            ...
        ]
    }
}
```

--------------------------------

### Query Documentation via HTTP GET

Source: https://docs.wemix.com/en/install-and-operation/end-node

Use this method to ask questions and retrieve specific information not explicitly found on the current page. The question should be self-contained and in natural language.

```HTTP
GET https://docs.wemix.com/en/install-and-operation/end-node.md?ask=<question>
```

--------------------------------

### Querying Documentation via HTTP GET

Source: https://docs.wemix.com/en/install-and-operation/block-producer-node

Use this method to dynamically query the documentation for specific information not explicitly present on the page. The question should be specific and self-contained.

```http
GET https://docs.wemix.com/en/install-and-operation/block-producer-node.md?ask=<question>
```

--------------------------------

### Migrations Smart Contract Example

Source: https://docs.wemix.com/en/dapp-developer/smart-contract/sample-contracts

A basic Solidity contract for managing migrations. It includes an owner modifier and a function to set the last completed migration.

```solidity
pragma solidity >=0.4.22 <0.9.0;

contract Migrations {
  address public owner = msg.sender;
  uint public last_completed_migration;

  modifier restricted() {
    require(
      msg.sender == owner,
      "This function is restricted to the contract's owner"
    );
    _;
  }

  function setCompleted(uint completed) public restricted {
    last_completed_migration = completed;
  }
}
```

--------------------------------

### Import an External WEMIX3.0 Account

Source: https://docs.wemix.com/en/quick-start/account

Prepare the keystore directory and copy your external account file into it to import the account. Ensure the keystore directory has restricted permissions.

```bash
mkdir {data_directory}/keystore
chmod 700 {data_directory}/keystore
cp <account-file-name> {data_directory}/keystore
```

--------------------------------

### Get Contract ABI Request Sample

Source: https://docs.wemix.com/en/dapp-developer/api-reference/contract-apis

This sample demonstrates how to request the ABI for a verified smart contract. Ensure you replace the contract address with the target contract's address and provide a valid API key.

```http
GET https://explorerapi.wemix.com/v1/contracts/0xB4EF146F31Bd7e680707658a9772D0cfD35c8df4/abi
api-key: 1ba5e446edf1997f67b51bf9e60b3fbba6fa1bf84301115292805d7e24f43539
```

--------------------------------

### ERC20 Token Total Supply Response

Source: https://docs.wemix.com/en/dapp-developer/api-reference/tokens-apis

Example response structure for the ERC20 token total supply query.

```JSON
{
    "status": "200",
    "message": "success",
    "results": {
        "data": {
            "total_supply": "9782909016599000000000000"
        }
    }
}
```

--------------------------------

### Query Documentation via HTTP GET

Source: https://docs.wemix.com/en/quick-start/start-node

Use this method to dynamically query the documentation for additional information not explicitly present on the page. The question should be specific and in natural language.

```http
GET https://docs.wemix.com/en/quick-start/start-node.md?ask=<question>
```

--------------------------------

### Initialize Truffle Project

Source: https://docs.wemix.com/en/dapp-developer/smart-contract/sample-contracts

Initialize a new Truffle project. This creates a standard project structure including contracts, migrations, and test directories.

```bash
$ truffle init
```

--------------------------------

### Execute Fee Delegation Sample Code

Source: https://docs.wemix.com/en/tutorial/use-fee-delegation

Run the provided JavaScript sample code using Node.js to perform fee delegation transactions. Ensure the utility files and sample code are in the same directory.

```bash
$ node FeeDelegateSampleCode.js
```

--------------------------------

### Query Documentation Dynamically

Source: https://docs.wemix.com/en/dapp-developer/api-reference

To obtain additional information not explicitly found on a page, you can perform an HTTP GET request to the current page URL with the `ask` query parameter. This allows for dynamic querying of the documentation.

```APIDOC
## GET /en/dapp-developer/api-reference.md?ask=<question>

### Description
Perform an HTTP GET request on the current page URL with the `ask` query parameter to dynamically query the documentation for specific information.

### Method
GET

### Endpoint
/en/dapp-developer/api-reference.md?ask=<question>

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific question you want to ask about the documentation, written in natural language.
```

--------------------------------

### Query Documentation with 'ask' Parameter

Source: https://docs.wemix.com/en/tutorial/erc-721-token/check-erc-721-token-api

Demonstrates how to query the documentation dynamically by appending an 'ask' parameter with a natural language question to the page URL.

```HTTP
GET https://docs.wemix.com/en/tutorial/erc-721-token/check-erc-721-token-api.md?ask=<question>
```

--------------------------------

### Create .rc Configuration File

Source: https://docs.wemix.com/en/install-and-operation/block-producer-node/install-guide

Sets up the configuration parameters for the Wemix node, including port, discovery mode, network type (Testnet/Mainnet), sync mode, and additional options. Adjust TESTNET to 1 for Testnet or remove the line for Mainnet.

```bash
PORT=8588 
DISCOVER=1        # 1 for enable discovery mode, 0 for disable discovery mode
TESTNET=1         # 1 for Testnet or remove this line for Mainnet
SYNC_MODE=full 
GWEMIX_OPTS="--txpool.nolocals --snapshot=false --maxpeers=100"
```

--------------------------------

### Configure gwemix Node (.rc file)

Source: https://docs.wemix.com/en/install-and-operation/block-producer-node/install-guide

Creates or updates the .rc file in GWEMIX_HOME with essential configuration parameters for the WEMIX node.

```bash
PORT=8588
DISCOVER=1        # 1 for enable discovery mode, 0 for disable discovery mode
TESTNET=1         # 1 for Testnet or remove this line for Mainnet
SYNC_MODE=full
GWEMIX_OPTS="--txpool.nolocals --snapshot=false --maxpeers=100"
```

--------------------------------

### Build gwemix with LevelDB (Ubuntu 22.04 LTS)

Source: https://docs.wemix.com/en/install-and-operation/block-producer-node/install-guide

Compiles the gwemix binary using LevelDB as the database backend. Set USE_ROCKSDB=NO to disable RocksDB.

```bash
make USE_ROCKSDB=NO
```

--------------------------------

### GET Request for ERC721 Token Transfers

Source: https://docs.wemix.com/en/dapp-developer/api-reference/account-apis

This snippet shows a sample GET request to retrieve ERC721 token transfer history for a specific account. Ensure you include the 'api-key' in the header.

```http
GET https://explorerapi.test.wemix.com/v1/accounts/0x43dc58449beb06bf350e0181703c617f0bfa78bf/token-transfer/erc721
api-key: 1ba5e446edf1997f67b51bf9e60b3fbba6fa1bf84301115292805d7e24f43539
```

--------------------------------

### Deploy Smart Contract with Hardhat

Source: https://docs.wemix.com/en/tutorial/create-smart-contract/hardhat

This script compiles your smart contract, deploys it with specified parameters, and logs the contract address. Ensure you have the Hardhat environment set up.

```javascript
const hre = require("hardhat");

async function main() {
  const currentTimestampInSeconds = Math.round(Date.now() / 1000);
  const unlockTime = currentTimestampInSeconds + 60;

  const lockedAmount = hre.ethers.utils.parseEther("0.001");

  const Lock = await hre.ethers.getContractFactory("Lock");
  const lock = await Lock.deploy(unlockTime, { value: lockedAmount });

  await lock.deployed();

  console.log(
    `Lock with ${ethers.utils.formatEther(
      lockedAmount
    )}ETH and unlock timestamp ${unlockTime} deployed to ${lock.address}`
  );
}

// We recommend this pattern to be able to use async/await everywhere
// and properly handle errors.
main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});
```

--------------------------------

### GET ERC20 Token Transfer Events by Address Request Sample

Source: https://docs.wemix.com/en/dapp-developer/api-reference/account-apis

This sample demonstrates how to request ERC20 token transfer events for a specific account address on the testnet. Ensure you include your API key in the request header.

```http
GET https://explorerapi.test.wemix.com/v1/accounts/0x43dc58449beb06bf350e0181703c617f0bfa78bf/token-transfer/erc20
api-key: 1ba5e446edf1997f67b51bf9e60b3fbba6fa1bf84301115292805d7e24f43539
```

--------------------------------

### Run WEMIX3.0 Testnet Binary Node

Source: https://docs.wemix.com/en/quick-start/start-node/use-binary

Use this command to run the WEMIX3.0 Testnet binary node. It includes the --wemix-testnet flag for testnet operation, synchronizes full chain data, and enables HTTP RPC on all interfaces. Specify your data folder using --datadir.

```bash
gwemix --wemix-testnet --syncmode full --datadir {data_folder} --http --http.addr 0.0.0.0
```

--------------------------------

### Get ERC721 Token Inventory (All Holders)

Source: https://docs.wemix.com/en/dapp-developer/api-reference/tokens-apis

Retrieve the inventory of ERC721 tokens. This endpoint can be used to get all tokens without specifying a holder address. Supports pagination via limit and offset query parameters.

```HTTP
GET https://explorerapi.wemix.com/v1/tokens/{contract_address}/inventory
```

--------------------------------

### Query Documentation Dynamically

Source: https://docs.wemix.com/en/design/eco-fund

Use this method to ask specific questions about the documentation when information is not explicitly present. The response includes direct answers and relevant excerpts.

```HTTP
GET https://docs.wemix.com/en/design/eco-fund.md?ask=<question>
```

--------------------------------

### Get Total Supply

Source: https://docs.wemix.com/en/dapp-developer/api-reference/contract-apis

Returns the total supply of tokens.

```Solidity
function totalSupply() public view virtual override returns (uint256) {
    return _totalSupply;
}
```

--------------------------------

### Get Decimals

Source: https://docs.wemix.com/en/dapp-developer/api-reference/contract-apis

Returns the number of decimals used for token representation. This is typically 18.

```Solidity
function decimals() public view virtual override returns (uint8) {
    return 18;
}
```

--------------------------------

### Clone go-wemix Repository

Source: https://docs.wemix.com/en/install-and-operation/block-producer-node/install-guide

Download the go-wemix source code from GitHub. This is the initial step for building the node from source.

```bash
git clone https://github.com/wemixarchive/go-wemix.git
```

--------------------------------

### Query Documentation Dynamically

Source: https://docs.wemix.com/en/install-and-operation/download

Use this method to ask questions about the documentation if the answer is not explicitly present. The question should be specific and in natural language.

```http
GET https://docs.wemix.com/en/install-and-operation/download.md?ask=<question>
```

--------------------------------

### Get Allowance

Source: https://docs.wemix.com/en/dapp-developer/api-reference/contract-apis

Returns the amount of tokens that the spender is allowed to withdraw from the owner's account.

```Solidity
function allowance(address owner, address spender) public view virtual override returns (uint256) {
    return _allowances[owner][spender];
}
```

--------------------------------

### Create a New WEMIX3.0 Account

Source: https://docs.wemix.com/en/quick-start/account

Use this command to generate a new WEMIX3.0 account file. Specify the desired output file name using the --out flag.

```bash
gwemix wemix new-account --out <account-file-name>
```

--------------------------------

### Copy and Untar Build to GWEMIX_HOME

Source: https://docs.wemix.com/en/install-and-operation/block-producer-node/install-guide

Copies the gwemix.tar.gz file to the specified GWEMIX_HOME directory and extracts its contents. Ensure GWEMIX_HOME is set and the directory exists.

```bash
GWEMIX_HOME='/opt/gwemix'
sudo mkdir -p $GWEMIX_HOME 
sudo chown $USER:$USER $GWEMIX_HOME
cp build/gwemix.tar.gz $GWEMIX_HOME/
cd $GWEMIX_HOME 
tar xvzf gwemix.tar.gz
```

--------------------------------

### Get list of transactions by address

Source: https://docs.wemix.com/en/dapp-developer/api-reference/account-apis

Retrieves a list of transactions associated with a specific address. Supports both Mainnet and Testnet.

```APIDOC
## GET /v1/accounts/{address_hash}/transactions

### Description
Retrieves a list of transactions associated with a specific address. Supports both Mainnet and Testnet.

### Method
GET

### Endpoint
- Mainnet: `https://explorerapi.wemix.com/v1/accounts/{address_hash}/transactions`
- Testnet: `https://explorerapi.test.wemix.com/v1/accounts/{address_hash}/transactions`

### Parameters
#### Path Parameters
- **address_hash** (string): The hash of the account address to query transactions for - Required
```

--------------------------------

### Get Transactions by Address

Source: https://docs.wemix.com/en/dapp-developer/api-reference/account-apis

Retrieve a list of transactions associated with a specific address. This endpoint supports both Mainnet and Testnet.

```http
GET https://explorerapi.wemix.com/v1/accounts/{address_hash}/transactions
```

```http
GET https://explorerapi.test.wemix.com/v1/accounts/{address_hash}/transactions
```

--------------------------------

### Deploy Smart Contract with Truffle

Source: https://docs.wemix.com/en/tutorial/create-smart-contract/truffle

Use this command to deploy your smart contracts to the WEMIX3.0 Testnet. Ensure you have WEMIX in your deployment account. The output shows deployment details like transaction hash, contract address, and cost.

```bash
❯ truffle migrate --reset --network wemix_testnet

Compiling your contracts...
===========================
> Everything is up to date, there is nothing to compile.


Starting migrations...
======================
> Network name:    'wemix_testnet'
> Network id:      1112
> Block gas limit: 105000000 (0x6422c40)


1_deploy_contracts.js
=====================

   Deploying 'Greeter'
   -------------------
   > transaction hash:    0xf180dc9041ca140547b62f1a600e2ab920cfe4776d4a5590511df3051d1d09b7
   > Blocks: 0            Seconds: 0
   > contract address:    0x450F45A74b6dC7b38E25Ca84F91C6a909B2e5728
   > block number:        21511136
   > block timestamp:     1679563304
   > account:             0x1134397c2E4aE380B7D4aa446c59D07977fCeB87
   > balance:             99.933323083999672507
   > gas used:            327493 (0x4ff45)
   > gas price:           100.000000001 gwei
   > value sent:          0 ETH
   > total cost:          0.032749300000327493 ETH

   > Saving artifacts
   -------------------------------------
   > Total cost:     0.032749300000327493 ETH

Summary
=======
> Total deployments:   1
> Final cost:          0.032749300000327493 ETH

```

--------------------------------

### Get Token Inventory

Source: https://docs.wemix.com/en/dapp-developer/api-reference/tokens-apis

Use this endpoint to retrieve the inventory of a specific token. Requires an API key for authentication.

```http
GET https://explorerapi.test.wemix.com/v1/tokens/0x62e1ad2a3a9ab55ba20bc4eb27fca655c41fdd88/inventory
api-key: 1ba5e446edf1997f67b51bf9e60b3fbba6fa1bf84301115292805d7e24f43539
```

--------------------------------

### Get list of Blocks Mined by address

Source: https://docs.wemix.com/en/dapp-developer/api-reference/account-apis

Retrieves a list of blocks mined by a specific address. Supports both Mainnet and Testnet.

```APIDOC
## GET /v1/accounts/{address_hash}/mined-blocks

### Description
Retrieves a list of blocks mined by a specific address. Supports both Mainnet and Testnet.

### Method
GET

### Endpoint
`https://explorerapi.wemix.com/v1/accounts/{address_hash}/mined-blocks` (Mainnet)
`https://explorerapi.test.wemix.com/v1/accounts/{address_hash}/mined-blocks` (Testnet)

### Parameters
#### Header Parameters
- **api-key** (string) - Required - API key for authentication

#### Path Parameters
- **address_hash** (string) - Required - The address of the miner.

#### Query Parameters
- **limit** (number) - Optional - Maximum number of records to retrieve. Defaults to 50.
- **offset** (number) - Optional - Start retrieving records from this offset. Defaults to 0.

### Request Example
```
GET https://explorerapi.test.wemix.com/v1/accounts/0xf04f49b134996023e980022502581c7278f3191a/mined-blocks
api-key: 1ba5e446edf1997f67b51bf9e60b3fbba6fa1bf84301115292805d7e24f43539
```

### Response
#### Success Response (200)
- **status** (string) - Status of the request.
- **message** (string) - Message of the request.
- **results** (json) - Results of the request.
  - **count** (string) - Total count of data.
  - **data** (List<Object>) - List of data.
    - **timestamp** (string) - UTC time when the transaction occurred.
    - **miner** (string) - Address of the miner.
    - **reward** (string) - Reward for the miner when mining this block.
    - **fees** (string) - Fee used when the block was created.
    - **block_number** (string) - Block height.
    - **gas_used** (string) - Number of used gas.
    - **gas_limit** (string) - Number of limit gas.
    - **transaction_count** (string) - Number of transactions in the block.
    - **mining_reward** (string) - Rewards specified when blocks are created (pmr).

#### Response Example
```json
{
    "status": "200",
    "message": "success",
    "results": {
        "count": "264",
        "data": [
            {
                "contract_address": "0x5f240d896ef64a6a13ec6cd8e530f465943ae354",
                "token_id": "39",
                "token_uri": "https://nile.blob.core.windows.net/metadata/LUS/39.json",
                "token_name": "Sample",
                "token_symbol": "SAMPLE"
            }
        ]
    }
}
```
```

--------------------------------

### Get WEMIX Balance for a single address

Source: https://docs.wemix.com/en/dapp-developer/api-reference/account-apis

Retrieves the WEMIX balance for one or more specified addresses. Supports both Mainnet and Testnet.

```APIDOC
## POST /v1/accounts/balance

### Description
Retrieves the WEMIX balance for one or more specified addresses. Supports both Mainnet and Testnet.

### Method
POST

### Endpoint
- Mainnet: `https://explorerapi.wemix.com/v1/accounts/balance`
- Testnet: `https://explorerapi.test.wemix.com/v1/accounts/balance`

### Parameters
#### Headers
- **Content-Type** (string): `application/json` - Required
- **api-key** (string): Your API key - Required

#### Request Body
- **addresses** (List<String>): A list of account addresses to query. Minimum 1, Maximum 20 - Required

### Request Example
```json
POST https://explorerapi.test.wemix.com/v1/accounts/balance
api-key: 1ba5e446edf1997f67b51bf9e60b3fbba6fa1bf84301115292805d7e24f43539
Content-Type: application/json

{
    "addresses" : [
                "0x76C6E4A0a2A141343c370D5d36276DA643B0c829",
                "0xcD07A6d6A8DE7CdD3F5E1224eBC3540f70AEC52f"
    ]
}
```

### Response
#### Success Response (200)
- **status** (String): Status of the request.
- **message** (String): Response message.
- **results** (Json): Contains the results of the query.
  - **results.data** (List<Object>): A list of balance data for each address.
    - **results.data.address** (String): The account address.
    - **results.data.balance** (String): The WEMIX balance of the address.

#### Response Example
```json
{
    "status": "200",
    "message": "success",
    "results": {
        "data": [
            {
                "address": "0x76C6E4A0a2A141343c370D5d36276DA643B0c829",
                "balance": "999999999989999999999589997401953799975191356000"
            },
            {
                "address": "0xcD07A6d6A8DE7CdD3F5E1224eBC3540f70AEC52f",
                "balance": "10000000000009000000000000000004"
            }
        ]
    }
}
```
```

--------------------------------

### Compile Smart Contracts with Hardhat

Source: https://docs.wemix.com/en/tutorial/create-smart-contract/hardhat

Command to compile Solidity smart contracts in a Hardhat project. Successful compilation generates artifacts and cache files.

```bash
$ npx hardhat compile
Compiled 1 Solidity files successfully
```
Tokens:
Raw