Native Fungible Token Example Application

This app is very similar to the Fungible Token Example Application. The difference is that this is a native token that will use system API calls for operations. The general aspects of how it works can be referred to the linked README. Bash commands will always be included here for testing purposes.

How It Works

Refer to Fungible Token Example Application - How It Works.

Usage

Setting Up

Most of this can also be referred to the fungible app README, except for at the end when compiling and publishing the bytecode, what you'll need to do will be slightly different.

export PATH="$PWD/target/debug:$PATH"
source /dev/stdin <<<"$(linera net helper 2>/dev/null)"

linera_spawn_and_read_wallet_variables linera net up --testing-prng-seed 37

Compile the native-fungible application WebAssembly binaries, and publish them as an application bytecode:

(cd examples/native-fungible && cargo build --release)

BYTECODE_ID="$(linera publish-bytecode \
    examples/target/wasm32-unknown-unknown/release/native_fungible_{contract,service}.wasm)"

Here, we stored the new bytecode ID in a variable BYTECODE_ID to be reused it later.

Creating a Token

Most of this can also be referred to the fungible app README, except for at the end when creating the application, you always need to pass NAT as the ticker_symbol because the Native Fungible App has it hardcoded to that.

linera wallet show
CHAIN_1=e476187f6ddfeb9d588c7b45d3df334d5501d6499b3f9ad5595cae86cce16a65  # default chain for the wallet
OWNER_1=7136460f0c87ae46f966f898d494c4b40c4ae8c527f4d1c0b1fa0f7cff91d20f  # owner of chain 1
CHAIN_2=256e1dbc00482ddd619c293cc0df94d366afe7980022bb22d99e33036fd465dd  # another chain in the wallet
OWNER_2=598d18f67709fe76ed6a36b75a7c9889012d30b896800dfd027ee10e1afd49a3  # owner of chain 2

The app can't mint new native tokens, so the initial balance is taken from the chain balance.

APP_ID=$(linera create-application $BYTECODE_ID \
    --json-argument "{ \"accounts\": {
        \"User:$OWNER_1\": \"100.\"
    } }" \
    --json-parameters "{ \"ticker_symbol\": \"NAT\" }" \
)

Using the Token Application

Refer to Fungible Token Example Application - Using the Token Application.

PORT=8080
linera service --port $PORT &

Using GraphiQL

• Navigate to http://localhost:8080/chains/$CHAIN_1/applications/$APP_ID.
• To get the current balance of user $OWNER_1, run the query:

    query{
        accounts {
            entry(
                key: "User:7136460f0c87ae46f966f898d494c4b40c4ae8c527f4d1c0b1fa0f7cff91d20f"
            ) {
                value
            }
        }
    }

• To get the current balance of user $OWNER_2, run the query:

    query{
        accounts {
            entry(
                key: "User:598d18f67709fe76ed6a36b75a7c9889012d30b896800dfd027ee10e1afd49a3"
            ) {
                value
            }
        }
    }

• To transfer 50 tokens from $OWNER_1 to $OWNER_2

    mutation {
        transfer(
            owner: "User:7136460f0c87ae46f966f898d494c4b40c4ae8c527f4d1c0b1fa0f7cff91d20f",
            amount: "50.",
            targetAccount: {
                chainId: "e476187f6ddfeb9d588c7b45d3df334d5501d6499b3f9ad5595cae86cce16a65",
                owner: "User:598d18f67709fe76ed6a36b75a7c9889012d30b896800dfd027ee10e1afd49a3"
            }
        )
    }

• To get the new balance of user $OWNER_1, run the query:

    query{
        accounts {
            entry(
                key: "User:7136460f0c87ae46f966f898d494c4b40c4ae8c527f4d1c0b1fa0f7cff91d20f"
            ) {
                value
            }
        }
    }

• To get the new balance of user $OWNER_2, run the query:

    query{
        accounts {
            entry(
                key: "User:598d18f67709fe76ed6a36b75a7c9889012d30b896800dfd027ee10e1afd49a3"
            ) {
                value
            }
        }
    }

Using web frontend

Refer to Fungible Token Example Application - Using web frontend.

cd examples/fungible/web-frontend
npm install --no-save

# Start the server but not open the web page right away.
BROWSER=none npm start &

echo "http://localhost:3000/$CHAIN_1?app=$APP_ID&owner=$OWNER_1&port=$PORT"
echo "http://localhost:3000/$CHAIN_1?app=$APP_ID&owner=$OWNER_2&port=$PORT"