Docs/usage

.envrc.example

@@ -0,0 +1,2 @@
+use flake
+export DIRENV_ACTIVE=1 # force direnv to always activate by adding a dummy environment variable

docs/sample_pystarport_configs/chain-main_sample.jsonnet

@@ -0,0 +1,59 @@
+{
+  'chainmain_777-1': {  // Cosmos chain ID: chainmain_777-1
+    cmd: 'chain-maind',
+    'start-flags': '--trace',
+
+    validators: [  // blockchain validators config
+      {
+        coins: '200000000000000000basetcro',
+        staked: '100000000000000000basetcro',
+        mnemonic: 'elbow flight coast travel move behind sister tell avocado road wait above',
+        base_port: 26750,
+      },
+      {
+        coins: '200000000000000000basetcro',
+        staked: '100000000000000000basetcro',
+        mnemonic: 'nasty large defy garage violin casual alarm blue marble industry infant inside',
+        base_port: 26760,
+      },
+    ],
+
+    accounts: [
+      {
+        name: 'alice',
+        coins: '100000000000000000000basetcro',
+        mnemonic: 'super develop desert oak load field ring jazz tray spray found novel',
+      },
+      {
+        name: 'bob',
+        coins: '100000000000000000000basetcro',
+        mnemonic: 'loyal legend allow glow wheel heavy pretty example tell peasant myself garlic battle bachelor buddy stand true grit manual letter wire alone polar glove',
+      },
+      {
+        name: 'relayer',  // account name must be "relayer" for IBC to work in pystarport
+        coins: '10000000000000000000000000basetcro',
+        mnemonic: 'summer account another open charge item reason double green winner six genuine glue daughter index pause bulb rival adult boss enlist bench oxygen asthma',
+      },
+    ],
+
+    config: {  // patch config.toml
+      consensus: {
+        timeout_commit: '5s',
+        create_empty_blocks_interval: '5s',
+      },
+    },
+
+    'app-config': {  // patch app.toml
+      'minimum-gas-prices': '0.025basetcro',
+    },
+
+    genesis: {  // patch genesis.json
+      consensus_params: {
+        block: {
+          max_bytes: '500000',
+          max_gas: '81500000',
+        },
+      },
+    },
+  },
+}

docs/sample_pystarport_configs/chain-main_sample.yaml

@@ -0,0 +1,38 @@
+chainmain_777-1: # Cosmos chain ID: chainmain_777-1
+  cmd: chain-maind
+  start-flags: "--trace"
+
+  validators: # blockchain validators config
+    - base_port: 26750
+      coins: 200000000000000000basetcro
+      mnemonic: elbow flight coast travel move behind sister tell avocado road wait above
+      staked: 100000000000000000basetcro
+    - base_port: 26760
+      coins: 200000000000000000basetcro
+      mnemonic: nasty large defy garage violin casual alarm blue marble industry infant inside
+      staked: 100000000000000000basetcro
+
+  accounts:
+    - name: alice
+      coins: 10000000000000000000000000basetcro
+      mnemonic: super develop desert oak load field ring jazz tray spray found novel
+    - name: bob
+      coins: 10000000000000000000000000basetcro
+      mnemonic: loyal legend allow glow wheel heavy pretty example tell peasant myself garlic battle bachelor buddy stand true grit manual letter wire alone polar glove
+    - name: relayer # account name must be "relayer" for IBC to work in pystarport
+      coins: 10000000000000000000000000basetcro
+      mnemonic: summer account another open charge item reason double green winner six genuine glue daughter index pause bulb rival adult boss enlist bench oxygen asthma
+
+  config: # patch config.toml
+    consensus:
+      create_empty_blocks_interval: 5s
+      timeout_commit: 5s
+
+  app-config: # patch app.toml
+    minimum-gas-prices: 0.025basetcro
+
+  genesis: # patch genesis.json
+    consensus_params:
+      block:
+        max_bytes: "500000"
+        max_gas: "81500000"

docs/sample_pystarport_configs/cronos_sample.jsonnet

@@ -0,0 +1,72 @@
+{
+  'cronos_777-1': { // Cosmos chain ID: cronos_777-1; EVM chain ID: 777
+    cmd: 'cronosd',
+    'start-flags': '--trace',
+
+    validators: [ // blockchain validators config
+      {
+        coins: '200000000000000000000basetcro, 2000000000000000000stake',
+        staked: '1000000000000000000stake',
+        gas_prices: '10000000000000basetcro',
+        mnemonic: 'elbow flight coast travel move behind sister tell avocado road wait above',
+        base_port: 26650,
+      },
+      {
+        coins: '200000000000000000000basetcro, 2000000000000000000stake',
+        staked: '1000000000000000000stake',
+        gas_prices: '10000000000000basetcro',
+        mnemonic: 'nasty large defy garage violin casual alarm blue marble industry infant inside',
+        base_port: 26660,
+      },
+    ],
+
+    accounts: [
+      {
+        name: 'alice',
+        coins: '100000000000000000000basetcro',
+        mnemonic: 'super develop desert oak load field ring jazz tray spray found novel',
+      },
+      {
+        name: 'bob',
+        coins: '100000000000000000000basetcro',
+        mnemonic: 'loyal legend allow glow wheel heavy pretty example tell peasant myself garlic battle bachelor buddy stand true grit manual letter wire alone polar glove',
+      },
+      {
+        name: 'relayer',
+        coins: '100000000000000000000basetcro',
+        mnemonic: 'summer account another open charge item reason double green winner six genuine glue daughter index pause bulb rival adult boss enlist bench oxygen asthma',
+      }
+    ],
+
+    config: { // patch config.toml
+      consensus: {
+        timeout_commit: '5s',
+        create_empty_blocks_interval: '5s',
+      },
+    },
+
+    'app-config': { // patch app.toml
+      'minimum-gas-prices': '5000000000000basetcro',
+      'json-rpc': {
+        address: '0.0.0.0:{EVMRPC_PORT}',
+        'ws-address': '0.0.0.0:{EVMRPC_PORT_WS}',
+      },
+    },
+
+    genesis: { // patch genesis.json
+      consensus: {
+        params: {
+          block: {
+            max_bytes: '1048576',
+            max_gas: '81500000',
+          },
+        },
+      },
+      evm: {
+        params: {
+          evm_denom: 'basetcro',
+        },
+      },
+    },
+  },
+}

docs/sample_pystarport_configs/cronos_sample.yaml

@@ -0,0 +1,47 @@
+cronos_777-1: # Cosmos chain ID: cronos_777-1; EVM chain ID: 777
+  cmd: cronosd
+  start-flags: "--trace"
+
+  validators: # blockchain validators config
+    - base_port: 26650
+      coins: 200000000000000000000basetcro, 2000000000000000000stake
+      gas_prices: 10000000000000basetcro
+      mnemonic: elbow flight coast travel move behind sister tell avocado road wait above
+      staked: 1000000000000000000stake
+    - base_port: 26660
+      coins: 200000000000000000000basetcro, 2000000000000000000stake
+      gas_prices: 10000000000000basetcro
+      mnemonic: nasty large defy garage violin casual alarm blue marble industry infant inside
+      staked: 1000000000000000000stake
+
+  accounts:
+    - name: alice
+      coins: 10000000000000000000000000basetcro
+      mnemonic: super develop desert oak load field ring jazz tray spray found novel
+    - name: bob
+      coins: 10000000000000000000000000basetcro
+      mnemonic: loyal legend allow glow wheel heavy pretty example tell peasant myself garlic battle bachelor buddy stand true grit manual letter wire alone polar glove
+    - name: relayer # account name must be "relayer" for IBC to work in pystarport
+      coins: 10000000000000000000000000basetcro
+      mnemonic: summer account another open charge item reason double green winner six genuine glue daughter index pause bulb rival adult boss enlist bench oxygen asthma
+
+  config: # patch config.toml
+    consensus:
+      create_empty_blocks_interval: 5s
+      timeout_commit: 5s
+
+  app-config: # patch app.toml
+    json-rpc:
+      address: 0.0.0.0:{EVMRPC_PORT}
+      ws-address: 0.0.0.0:{EVMRPC_PORT_WS}
+    minimum-gas-prices: 5000000000000basetcro
+
+  genesis: # patch genesis.json
+    consensus:
+      params:
+        block:
+          max_bytes: "1048576"
+          max_gas: "81500000"
+    evm:
+      params:
+        evm_denom: basetcro

docs/sample_pystarport_configs/ibc_sample.jsonnet

@@ -0,0 +1,49 @@
+local chainmain_devnet = import 'chain-main_sample.jsonnet';
+local cronos_devnet = import 'cronos_sample.jsonnet';
+
+{
+  'cronos_777-1': cronos_devnet['cronos_777-1'] { 'coin-type': 60 },
+  'chainmain_777-1': chainmain_devnet['chainmain_777-1'] { 'coin-type': 1 },
+  relayer: {
+    // https://hermes.informal.systems/documentation/configuration/index.html
+    chains: [
+      {
+        id: 'chainmain_777-1',  // id needs to match the chain ID
+        account_prefix: 'tcro',
+        default_gas: 1000000,
+        max_gas: 3000000,
+        gas_multiplier: 1.1,
+        address_type: {
+          derivation: 'cosmos',
+        },
+        gas_price: {
+          price: 0.025,
+          denom: 'basetcro',
+        },
+      },
+      {
+        id: 'cronos_777-1',  // id needs to match the chain ID
+        account_prefix: 'tcrc',
+        default_gas: 600000,
+        max_gas: 3600000,
+        gas_multiplier: 1.1,
+        address_type: {
+          derivation: 'ethermint',
+          proto_type: {
+            pk_type: '/ethermint.crypto.v1.ethsecp256k1.PubKey',
+          },
+        },
+        gas_price: {
+          price: 100000000000000,
+          denom: 'basetcro',
+        },
+        extension_options: [
+          {
+            type: 'ethermint_dynamic_fee',
+            value: '500000000000',
+          },
+        ],
+      },
+    ],
+  },
+}

docs/sample_pystarport_configs/ibc_sample.yaml

@@ -0,0 +1,116 @@
+chainmain_777-1: # Cosmos chain ID: chainmain_777-1
+  cmd: chain-maind
+  start-flags: "--trace"
+  coin-type: 1
+
+  validators: # blockchain validators config
+    - base_port: 26750
+      coins: 200000000000000000basetcro
+      mnemonic: elbow flight coast travel move behind sister tell avocado road wait above
+      staked: 100000000000000000basetcro
+    - base_port: 26760
+      coins: 200000000000000000basetcro
+      mnemonic: nasty large defy garage violin casual alarm blue marble industry infant inside
+      staked: 100000000000000000basetcro
+
+  accounts:
+    - name: alice
+      coins: 10000000000000000000000000basetcro
+      mnemonic: super develop desert oak load field ring jazz tray spray found novel
+    - name: bob
+      coins: 10000000000000000000000000basetcro
+      mnemonic: loyal legend allow glow wheel heavy pretty example tell peasant myself garlic battle bachelor buddy stand true grit manual letter wire alone polar glove
+    - name: relayer # account name must be "relayer" for IBC to work in pystarport
+      coins: 10000000000000000000000000basetcro
+      mnemonic: summer account another open charge item reason double green winner six genuine glue daughter index pause bulb rival adult boss enlist bench oxygen asthma
+
+  config: # patch config.toml
+    consensus:
+      create_empty_blocks_interval: 5s
+      timeout_commit: 5s
+
+  app-config: # patch app.toml
+    minimum-gas-prices: 0.025basetcro
+
+  genesis: # patch genesis.json
+    consensus_params:
+      block:
+        max_bytes: "500000"
+        max_gas: "81500000"
+
+cronos_777-1: # Cosmos chain ID: cronos_777-1; EVM chain ID: 777
+  cmd: cronosd
+  start-flags: "--trace"
+  coin-type: 60
+
+  validators: # blockchain validators config
+    - base_port: 26650
+      coins: 200000000000000000000basetcro, 2000000000000000000stake
+      gas_prices: 10000000000000basetcro
+      mnemonic: elbow flight coast travel move behind sister tell avocado road wait above
+      staked: 1000000000000000000stake
+    - base_port: 26660
+      coins: 200000000000000000000basetcro, 2000000000000000000stake
+      gas_prices: 10000000000000basetcro
+      mnemonic: nasty large defy garage violin casual alarm blue marble industry infant inside
+      staked: 1000000000000000000stake
+
+  accounts:
+    - name: alice
+      coins: 10000000000000000000000000basetcro
+      mnemonic: super develop desert oak load field ring jazz tray spray found novel
+    - name: bob
+      coins: 10000000000000000000000000basetcro
+      mnemonic: loyal legend allow glow wheel heavy pretty example tell peasant myself garlic battle bachelor buddy stand true grit manual letter wire alone polar glove
+    - name: relayer # account name must be "relayer" for IBC to work in pystarport
+      coins: 10000000000000000000000000basetcro
+      mnemonic: summer account another open charge item reason double green winner six genuine glue daughter index pause bulb rival adult boss enlist bench oxygen asthma
+
+  config: # patch config.toml
+    consensus:
+      create_empty_blocks_interval: 5s
+      timeout_commit: 5s
+
+  app-config: # patch app.toml
+    json-rpc:
+      address: 0.0.0.0:{EVMRPC_PORT}
+      ws-address: 0.0.0.0:{EVMRPC_PORT_WS}
+    minimum-gas-prices: 5000000000000basetcro
+
+  genesis: # patch genesis.json
+    consensus:
+      params:
+        block:
+          max_bytes: "1048576"
+          max_gas: "81500000"
+    evm:
+      params:
+        evm_denom: basetcro
+
+relayer: # refer here (https://hermes.informal.systems/documentation/configuration/description.html) for more configs
+  chains:
+    - id: chainmain_777-1 # id needs to match the chain ID
+      account_prefix: tcro
+      default_gas: 1000000
+      max_gas: 3000000
+      gas_multiplier: 1.1
+      address_type:
+        derivation: cosmos
+      gas_price:
+        price: 0.025
+        denom: basetcro
+    - id: cronos_777-1 # id needs to match the chain ID
+      account_prefix: tcrc
+      default_gas: 600000
+      max_gas: 3600000
+      gas_multiplier: 1.1
+      address_type:
+        derivation: ethermint
+        proto_type:
+          pk_type: /ethermint.crypto.v1.ethsecp256k1.PubKey
+      gas_price:
+        price: 100000000000000
+        denom: "basetcro"
+      extension_options:
+        - type: ethermint_dynamic_fee
+          value: "500000000000"