GitHub - nervosnetwork/tippy: One click CKB devnet

Getting Started

You can download Tippy binary for your platform of choice from the releases page.

Tippy is pre-built as self-contained .Net Core application. You don't have to install .Net Core to run it. If you're running it on Linux or macOS and want to use the Debugger feature, please install debugger dependencies following this section.

On Windows:

Download tippy-win-x64.zip
Extract the zip file (default to tippy-win-x64)
Enter tippy-win-x64 folder and click Tippy.exe to start

On Linux:

1、start with docker

docker run -it --rm -v /mnt/f/docker.tippy.user/CKBSTATE:/app/CKBSTATE  -v /mnt/f/docker.tippy.user/scripts:/app/BinDeps/scripts   -p 8000:80  --name tippy registry.cn-hangzhou.aliyuncs.com/nervos/tippy:0.3.3

2、also you can start with tippy Run files

Download tippy-linux-x64.tar.gz
Extract the tar.gz file (default to tippy-linux-x64)
Make Tippy executable: chmod +x ./tippy-linux-x64/Tippy
cd tippy-linux-x64 then run ./Tippy to start

We also provide a Homebrew formula to install with one-liner:

brew install nervosnetwork/tap/tippy-linux

Then simply run tippy to start

On macOS:

Download Tippy.dmg
Open the dmg file and drag Tippy.app to /Applications folder
From /Applications click Tippy.app to start

We also provide a Homebrew cask to install with one-liner:

brew install nervosnetwork/tap/tippy

Tippy Console and UI

While Tippy runs as a console application, it also provides web UI. By default the dashboard UI will be opened automatically, if not you can access it by visiting http://localhost:5000/ from a browser.

Override the App URL

If you want to access the Web UI and Tippy API from another URL than the default http://localhost URL, there are two options.

1. Set Environment Variable `ASPNETCORE_URLS`

On Linux you can set the ASPNETCORE_URLS Environment Variable to override the default App URL. For example, launch Tippy this way to use http://0.0.0.0:5000:

ASPNETCORE_URLS="http://0.0.0.0:5000" tippy

2. Modify `appsettings.json`

You can also modify appsettings.json file to override the default App URL. For example, add the following section to use http://0.0.0.0:5000:

"Kestrel": {
  "EndPoints": {
    "Http": {
      "Url": "http://0.0.0.0:5000"
    }
  }
}

appsettings.json locates in /Applications/Tippy.app/Contents/MacOS/ on macOS and in the root Tippy folder on Windows/Linux. If Tippy is installed with Homebrew on Linux then it locates in /home/linuxbrew/.linuxbrew/Cellar/tippy-linux/[version]/libexec/.

Debugger

Tippy ships with CKB Debugger to help off-chain contract development.

Note: debugger is only supported on Linux and macOS. It's unavailable on Windows.

Install Dependencies

Debugger requires ttyd and gdb. We recommend that you install them with homebrew.

For Linux

brew install ttyd gdb

For macOS, build gdb from source (with --build-from-source option)

brew install gdb --HEAD --build-from-source
brew install ttyd

API

Tippy exposes a set of RPCs in JSON-RPC 2.0 protocols for controlling a devchain.

It also proxies API calls to the active running devchain for transparent CKB interactions.

The URL of Tippy RPC is http://localhost:5000/api.

CKB RPCs

For CKB RPCs, simply call any API method with Tippy API URL. For example:

echo '{
  "id": 2,
  "jsonrpc": "2.0",
  "method": "get_tip_block_number",
  "params": []
}' \
| tr -d '\n' \
| curl -H 'content-type: application/json' -d @- \
http://localhost:5000/api

See CKB JSON-RPC doc for more information.

The `send_transaction` API method

If you call CKB's send_transaction API method through Tippy API, the transactions will be recorded in Tippy. Go to the Recorded Transactions tab to view them.

Tippy RPCs

Method `create_chain`

create_chain({assembler_lock_arg, genesis_issued_cells})
- assembler_lock_arg(optional): Lock arg for block assembler (miner address).
- genesis_issued_cells(optional): An array of genesis issued cells. See example for the structure.
result: { id, name }

Create a devchain and set it as current active chain.

Example

Request

{
  "id": "1",
  "jsonrpc": "2.0",
  "method": "create_chain",
  "params": [
    {
      "assembler_lock_arg": "0xc8328aabcd9b9e8e64fbc566c4385c3bdeb219d8",
      "genesis_issued_cells": [
          {
            "capacity": "0x5af3107a4000",
            "lock": {
              "code_hash": "0x9bd7e06f3ecf4be0f2fcd2188b23f1b9fcc88e5d4b65a8637b17723bbda3cce8",
              "args": "0xf2cb132b2f6849ef8abe57e98cddf713bb8d71cb",
              "hash_type": "type"
            }
        }
      ]
    }
  ]
}

Response

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "id": 4,
    "name": "CKB devchain"
  }
}

Method `delete_chain`

delete_chain(chain_id)
- chain_id: ID of the chain to delete.
result: "ok"

Delete a chain.

Example

Request

{
  "id": "1",
  "jsonrpc": "2.0",
  "method": "delete_chain",
  "params": [4]
}

Response

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": "ok"
}

Method `list_chains`

result: [{ id, name, chain_type, is_active }]

List all chains.

Example

Request

{
  "id": "1",
  "jsonrpc": "2.0",
  "method": "list_chains",
  "params": []
}

Response

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": [
    {
      "id": 1,
      "name": "Aggron",
      "chain_type": "testnet",
      "is_active": false
    },
    {
      "id": 2,
      "name": "CKB devchain",
      "chain_type": "dev",
      "is_active": true
    }
  ]
}

Method `set_active_chain`

set_active_chain(chain_id)
- chain_id: ID of the chain to set to active.
result: "ok"

Set active chain.

Example

Request

{
  "id": "1",
  "jsonrpc": "2.0",
  "method": "set_active_chain",
  "params": [4]
}

Response

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": "ok"
}

Method `start_chain`

start_chain()
result: "ok"

Start the current active chain.

Example

Request

{
  "id": "1",
  "jsonrpc": "2.0",
  "method": "start_chain",
  "params": []
}

Response

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": "ok"
}

Method `stop_chain`

stop_chain()
result: "ok"

Stop the current active chain if it's running.

Example

Request

{
  "id": "1",
  "jsonrpc": "2.0",
  "method": "stop_chain",
  "params": []
}

Response

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": "ok"
}

Method `start_miner`

start_miner()
result: "ok"

Start the default miner.

Example

Request

{
  "id": "1",
  "jsonrpc": "2.0",
  "method": "start_miner",
  "params": []
}

Response

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": "ok"
}

Method `stop_miner`

stop_miner()
result: "ok"

Stop the current running default miner.

Example

Request

{
  "id": "1",
  "jsonrpc": "2.0",
  "method": "stop_miner",
  "params": []
}

Response

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": "ok"
}

Method `mine_blocks`

mine_blocks(number_of_blocks)
result: "Wait for blocks to be mined."

Mine number_of_blocks blocks at the interval of 1 second.

Example

Request

{
  "id": "1",
  "jsonrpc": "2.0",
  "method": "mine_blocks",
  "params": [3]
}

Response

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": "Wait for blocks to be mined."
}

Method `revert_blocks`

revert_blocks(number_of_blocks)
result: "Reverted blocks."

Mine number_of_blocks blocks at the interval of 1 second.

Example

Request

{
  "id": "1",
  "jsonrpc": "2.0",
  "method": "revert_blocks",
  "params": [3]
}

Response

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": "Reverted blocks."
}

Method `ban_transaction`

ban_transaction(tx_hash, type)
- tx_hash: Tx hash of the transaction.
- type: Deny type, propose or commit.
result: "Added to denylist."

Add a tx to denylist.

Example

Request

{
  "id": "1",
  "jsonrpc": "2.0",
  "method": "ban_transaction",
  "params": ["0x9a0580274e9921e04e139214b58ffc60df1625055ab7806ee635b56d329d7732", "propose"]
}

Response

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": "Added to denylist."
}

Method `unban_transaction`

unban_transaction(tx_hash, type)
- tx_hash: Tx hash of the transaction.
- type: Deny type, propose or commit.
result: "Removed from denylist."

Remove a tx from denylist.

Example

Request

{
  "id": "1",
  "jsonrpc": "2.0",
  "method": "unban_transaction",
  "params": ["0x9a0580274e9921e04e139214b58ffc60df1625055ab7806ee635b56d329d7732", "propose"]
}

Response

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": "Removed from denylist."
}

Contributing

Fetch the codebase: git clone https://github.com/nervosnetwork/tippy.git
Install .NET Core SDK 5.0
Install CKB related binary dependencies:

./tools/download-binaries.ps1

or

./tools/download-binaries.sh

Open Tippy.sln with Visual Studio 2019 (v16.8 or later), Visual Studio 2019 for Mac (v8.8 or later), or Visual Studio Code
Select Tippy as startup project for the solution, then start debugging it
Browse http://localhost:5000/ in your browser

Add Database Migration

EF models are located in Tippy.Core project. When making any changes to them and migration is needed, run this

dotnet ef migrations add [MigrationName] --project src/Tippy.Core --startup-project src/Tippy

Or open Package Manager Console in Visual Studio, select Tippy.Core as Default project, then run

Add-Migration [MigrationName]

Design

Tippy's page design is based on mazipan/bulma-admin-dashboard-template.

Q&A

I'm using Tippy in WSL and I can see the Tippy UI via localhost:5000, but the height is always 0

This is probably because you have proxy enabled. Try launching Tippy with the following command

unset HTTPS_PROXY HTTP_PROXY http_proxy https_proxy
path/to/Tippy

Where can I find the CKB node data started with Tippy

Linux: ~/.config/Tippy
Win: ~/ApplicationData/Tippy

Name		Name	Last commit message	Last commit date
Latest commit History 605 Commits
.github/workflows		.github/workflows
src		src
tests		tests
tools		tools
.ckb-debugger-version		.ckb-debugger-version
.ckb-indexer-version		.ckb-indexer-version
.ckb-version		.ckb-version
.dockerignore		.dockerignore
.editorconfig		.editorconfig
.gitignore		.gitignore
.gitmodules		.gitmodules
LICENSE		LICENSE
README.md		README.md
Tippy.sln		Tippy.sln
debugger.png		debugger.png
dockerfile		dockerfile
logo.png		logo.png
tippy.png		tippy.png

Folders and files

Latest commit

History

Repository files navigation

Getting Started

On Windows:

On Linux:

1、start with docker

2、also you can start with tippy Run files

On macOS:

Tippy Console and UI

Override the App URL

1. Set Environment Variable ASPNETCORE_URLS

2. Modify appsettings.json

Debugger

Install Dependencies

API

CKB RPCs

The send_transaction API method

Tippy RPCs

Method create_chain

Method delete_chain

Method list_chains

Method set_active_chain

Method start_chain

Method stop_chain

Method start_miner

Method stop_miner

Method mine_blocks

Method revert_blocks

Method ban_transaction

Method unban_transaction

Contributing

Add Database Migration

Design

Q&A

I'm using Tippy in WSL and I can see the Tippy UI via localhost:5000, but the height is always 0

Where can I find the CKB node data started with Tippy

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 18

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

1. Set Environment Variable `ASPNETCORE_URLS`

2. Modify `appsettings.json`

The `send_transaction` API method

Method `create_chain`

Method `delete_chain`

Method `list_chains`

Method `set_active_chain`

Method `start_chain`

Method `stop_chain`

Method `start_miner`

Method `stop_miner`

Method `mine_blocks`

Method `revert_blocks`

Method `ban_transaction`

Method `unban_transaction`

Packages