Godwoken Polyman

this project is original fork from godwoken-example. the new project called godwoken-polyman, is designed to be running inside godwoken-kicker, where it leverage the polyman to auto deploy a godwoken/polyjuice chain and setup everything needed for developer to deploy their old ETH smart contract on godwoken in the quickest way.

How it works

this project contains 3 http-servers and 1 frontend client.

backend:

setup-server: aka "CallPolyman" in kicker, provide prepare-sudt/prepare-money/.. some system setup service
main-server: backend Api for UI client
ui-server: simple static server for hosting react client

frontend:

ui: react project under client sub-packages

Apis

test api

Prebuilds

local development:

make build-test-image # (latest-test tag)

push to docker:

make build-push # needs login, will ask you for tag

docker image: https://hub.docker.com/r/nervos/godwoken-polyman-prebuilds

How to run

build deps and UI

yarn && yarn prepare-ui

set Config file

cp <your godwoken `config.toml` file> packages/runner/configs/config.toml
cp <your godwoken `scripts-deploy-result.json` file> packages/runner/configs/scripts-deploy-result.json
yarn gen-config

or generate placeholder config files(for test)

yarn init_placeholder_config

change the miner config under packages/runner/configs/polyman-config.json

{
    "miner_private_key": "<your miner private key in CKB devnet>",
    "miner_ckb_devnet_addr": "<your miner devnet address>"
}

prepare some money

yarn workspace @godwoken-polyman/runner start-call-polyman
// after setup-server is up and running, call http get localhost:6102/prepare-money

prepare sudt system scripts (deploy such one)

yarn workspace @godwoken-polyman/runner start-call-polyman
// after setup-server is up and running, call http get localhost:6102/prepare_sudt_scripts

start the main service and frontend website:

yarn start          # inside docker-compose environment
yarn start:normal   # outside docker, your local environment

the service will wait until godwoken rpc server is up and running, after that, it will auto deploy a polyjuice chain with creator_id like 0x3.

then you can access http://localhost:6100 to deploy your ETH smart contract.

Run outside docker-compose

for each command, you can run :normal after, it will using the localhost url for godwoken and ckb components.

Another simple way to do this is to just change the rpc url to your own one under components section in /packages/runner/configs/polyman-config.json

Testnet

If you want to start this API server interacting with CKB Aggron Testnet, please update your own testnet account key pair into packages/runner/configs/polyman-config.json.

{
  "user_private_key": "<Your private key on CKB Aggron testnet>",
  "user_ckb_devnet_addr": "<Your address on CKB Aggron testnet>",
}

You can use Nervos Aggron Faucet to make sure that there are enough testnet CKBytes in your account.

Note: The account-cli tool uses a builtin CKB Indexer, which needs to fully synchronize with a Testnet CKB Indexer before it can create transactions. This may take a long time, but there are 2 ways to speed it up:

Copy the testnet indexer data from testnet-polyjuice-api:latest docker image

docker run --rm \
  -v`pwd`/db/ckb-indexer-testnet:/ckb-indexer-testnet \
  ghcr.io/flouse/testnet-polyjuice-api:latest bash -c \
  "cp /godwoken-polyman/packages/runner/db/ckb-indexer-testnet/* packages/runner/db/ckb-indexer-testnet/"

Download testnet indexer snapshot data from Amazon S3

And then, start the API service with testnet mode without UI.

cd packages/runner && yarn start:testnet

RetricSu / godwoken-polyman