Skip to content

dkackman/chia-repl

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

chia-repl

CodeQL Node.js CI Version Version Monthly Downloads Total Downloads

A REPL tool for Chia that incorporates various chia and crypto utilities in a single, interactive node environment.

The wiki has more examples and detail.

Packaged

npm install -g chia-repl
chia-repl
๐ŸŒฟ Welcome to Chia!
๐ŸŒฟ 

From Source

npm install
npm start -w chia-repl
> [email protected] start
> node index.js

๐ŸŒฟ Welcome to Chia!
๐ŸŒฟ 

Uses the node repl so the CLI works like node's.

Commands

REPL commands always start with . and are lsited with .help.

๐ŸŒฟ .help
.break              Sometimes you get stuck, this gets you out
.clear              Break, and also clear the local context
.connect            Opens the websocket connection to the chia daemon using the currently loaded connection
.credits            Shows credits for the various tool authors
.disconnect         Closes the websocket connection to the chia daemon
.editor             Enter editor mode
.exit               Exit the REPL
.help               Print this help message
.list-connections   Displays a list of saved connection names
.listen             Opens the websocket connection to the chia daemon and listens for `wallet_ui` messages
.load               Load JS from a file into the REPL session
.load-connection    Loads a saved connection with an optional name
.more-help          Shows more help about using the environment
.save               Save all evaluated commands in this REPL session to a file
.save-connection    Saves the current connection with an optional name
.save-options       Saves the options
.version            Shows the version of this application

Press Ctrl+C to abort current expression, Ctrl+D to exit the REPL
๐ŸŒฟ

Globals

Various global objects and functions are available within the REPL environment and can be listed with .more-help. Some of these configure the connection and REPL options, while other enable interaction with the chia node, utility functions, and the clvm.

๐ŸŒฟ .more-help
These global objects are available within the REPL environment
bls             BLS signature functions
chia            Chia node rpc services. This object is only availble after a successful .connect
                All functions on these chia services are async & awaitable: crawler, daemon, farmer, full_node, harvester, wallet, simulator
clvm_tools      clvm_tools-js functions (run, brun, opc, opd, read_ir)
clvm            clvm-js (Program, SExp etc.)
utils           Chia-utils (bech32m and other helpers)
connection      Properties of the current connection
options         Configurable REPL options
contentHasher   A helper to generate NFT compatible hashes for files or remote resources
metadataFactory A helper to generate NFT and Collection metadata
minter          The NFT minter. Only availble when connected to the chia daemon
repl.builtinModules
                Show other available builtin node modules

These global functions are invocable within the REPL environment
compile(chiaLisp, prefix, ...compileArgs)
                Compiles a chialisp program into its address, clvm, puzzle, and puzzle_hash
test(chiaLisp, compileArgs = [], programArgs = []))
                Runs a chialisp program and displays its output

Examples

The global connection context object has the host, port, and path to cert files. These properties can be set inside the repl with connection.host = "my-host" etc. Once connected to the daemon each of the service endpoints becomes availalbe as an awaitable context function.

Knowing the chia rpc api will help immensely. All endpoints and data payloads should work. Since it is a full nodejs REPL environment, core modules like fs and http are available.

Mint a simple NFT

๐ŸŒฟ let dataFileInfo = {
    name: 'test-nft-by-you',
    type: 'image/jpg',
    filepath: 'E:\\nft\\flower.jpg'
};
๐ŸŒฟ let mintingInfo = {
    wallet_id: 2,
    target_address: 'txch10kn82kl6hqv47qzeh4ugmqjr5mmdcnrlymfx8wl9nrhhkyxnzfkspna7l9',
};
๐ŸŒฟ let collectionMetaData = metadataFactory.createCollectionMetadata('test-nft-collection-by-you');
๐ŸŒฟ let nftMetadata = metadataFactory.createNftMetadata('test-nft-by-you', collectionMetaData);
๐ŸŒฟ await minter.createNftFromFile(dataFileInfo, mintingInfo, nftMetadata);
{
  spend_bundle: {
    aggregated_signature: '0x99e39df189f009a4679067d212a6845b7bfec05452d9696de79907a861239de3cbd247a27c39b2ca2492740f9f4aab58028ebf035f40597d16ddeee5194f8dfaa8c8ec8e90b6c91fce60944f0e55997b443be63ed8e9dcb9d685a9b473e1b441',
    coin_solutions: [ [Object], [Object], [Object] ]
  },
  success: true,
  wallet_id: 2
}

Run a CLVM Program

๐ŸŒฟ const {SExp, OPERATOR_LOOKUP, KEYWORD_TO_ATOM, h, t, run_program} = clvm;
๐ŸŒฟ const plus = h(KEYWORD_TO_ATOM["+"]);
๐ŸŒฟ const q = h(KEYWORD_TO_ATOM["q"]);
๐ŸŒฟ const program = SExp.to([plus, 1, t(q, 175)]);
๐ŸŒฟ const env = SExp.to(25);
๐ŸŒฟ const [cost, result] = run_program(program, env, OPERATOR_LOOKUP);
๐ŸŒฟ let isEqual = result.equal_to(SExp.to(25 + 175));
๐ŸŒฟ isEqual = result.as_int() === (25 + 175);
true
๐ŸŒฟ cost
833
๐ŸŒฟ result
SExp { _atom: Bytes { _b: Uint8Array(2) [ 0, 200 ] }, _pair: null }
๐ŸŒฟ 

Compile a Simple Program with clvm_tools

๐ŸŒฟ clvm_tools.run("(mod ARGUMENT (+ ARGUMENT 3))")
'(+ 1 (q . 3))'
๐ŸŒฟ clvm_tools.brun(_, '1')
'4'
๐ŸŒฟ

Compile a Simple Program From a File

๐ŸŒฟ clvm_tools.run('../examples/factorial.clsp')
'(a (q 2 2 (c 2 (c 5 ()))) (c (q 2 (i (= 5 (q . 1)) (q 1 . 1) (q 18 5 (a 2 (c 2 (c (- 5 (q . 1)) ()))))) 1) 1))'
๐ŸŒฟ clvm_tools.brun(_, '(5)')
'120'
๐ŸŒฟ

Compile a ChiaLisp Program

๐ŸŒฟ compile('../examples/piggybank.clsp', 'xch', '-i../examples/include')
{
  address: 'tcxh1smq2mvt8mdmulp7q5tvwh8rn8g6u8ykfr5020a3aj3mj3hsha5ns3zea78',
  clvm: '(a (q 2 (i (> 11 5) (q 2 (i (> 11 14) (q 4 (c 10 (c 4 (c 11 ()))) (c (c 10 (c 23 (q ()))) ())) (q 4 (c 10 (c 23 (c 11 ()))) ())) 1) (q 8)) 1) (c (q 0xcafef00d 51 . 500) 1))', 
  puzzle: 'ff02ffff01ff02ffff03ffff15ff0bff0580ffff01ff02ffff03ffff15ff0bff0e80ffff01ff04ffff04ff0affff04ff04ffff04ff0bff80808080ffff04ffff04ff0affff04ff17ffff01ff80808080ff808080ffff01ff04ffff04ff0affff04ff17ffff04ff0bff80808080ff808080ff0180ffff01ff088080ff0180ffff04ffff01ff84cafef00dff338201f4ff018080',
  puzzle_hash: '86c0adb167db77cf87c0a2d8eb9c733a35c392c91d1ea7f63d947728de17ed27'
}

Test a ChiaLisp Program

๐ŸŒฟ test('(mod ARGUMENT (+ ARGUMENT 3))', [], [ '15' ])
'18'

Connecting and Calling a Node Function

๐ŸŒฟ .connect
Connecting to wss://localhost:55400...
done
๐ŸŒฟ await chia.full_node.get_network_info()
{ network_name: 'testnet10', network_prefix: 'txch', success: true }
๐ŸŒฟ

Chaining Calls

Since it is a javascript environment, variables can be defined and set, and are preserved through. The special value _ can also be used to chain function calls.

๐ŸŒฟ await chia.full_node.get_blockchain_state()
blockchain_state: {
  ...
}
๐ŸŒฟ _.blockchain_state.peak.header_hash
'0x098b7fd5768174776eb4a29cedcabffb21c487b592c73f72ac33bc4ffecf6c38'
๐ŸŒฟ await chia.full_node.get_block({ header_hash: _ })
{
  block: {
    ...
  }
}
๐ŸŒฟ

OpenAPI Helpers for RPC Payloads

๐ŸŒฟ chia.daemon.getPayloadDescriptor('is_running')
{
  type: 'object',
  required: [ 'service' ],
  properties: { service: { type: 'string' } }
}
๐ŸŒฟ var p = chia.daemon.makePayload('is_running')
undefined
๐ŸŒฟ p.service = 'chia_fulll_node'
'chia_fulll_node'
๐ŸŒฟ await chia.daemon.is_running(p)
{ is_running: false, service_name: 'chia_fulll_node', success: true }

BLS Support

๐ŸŒฟ var seed = Uint8Array.from([
...   0,  50, 6,  244, 24,  199, 1,  25,  52,  88,  192,
...   19, 18, 12, 89,  6,   220, 18, 102, 58,  209, 82,
...   12, 62, 89, 110, 182, 9,   44, 20,  254, 22
... ]);
undefined
๐ŸŒฟ bls.AugSchemeMPL.keyGen(seed)
$38c91b9e16a98741$export$8f54525b330fd87b {
  value: 25076100791286022435148702897030204761993316905161740767284798605189048279853n
}
๐ŸŒฟ

chia and its logo are the registered trademark or trademark of Chia Network, Inc. in the United States and worldwide.