Security News
ESLint is Now Language-Agnostic: Linting JSON, Markdown, and Beyond
ESLint has added JSON and Markdown linting support with new officially-supported plugins, expanding its versatility beyond JavaScript.
a REPL connecting to Cosmos blockchains using the @cosmjs suite of libraries
@csli/repl
— a REPL using @cosmjsFirst and foremost, shout-out to Simon Warta for making the @cosmjs/cli, which is where most of this code is taken from. It feels like the intentions of this project will likely depart far enough from the original that it makes sense to have its own package.
The cslir
executable is available via npm. We recommend local
installations to your demo project.
$ yarn add @csli/repl --dev
$ ./node_modules/./bin/cslir
$ npm install @csli/repl --save-dev
$ ./node_modules/./bin/cslir
$ yarn global add @csli/repl
$ cslir
$ npm install -g @csli/repl
$ cslir
@csli/repl
and run cslir
as shown above./bin/cslir --init examples/local_faucet.ts
// Get account information
const account = await client.getAccount(faucetAddress);
// Craft a send transaction
const emptyAddress = Bech32.encode("cosmos", Random.getBytes(20));
const memo = "My very first tx!";
const msgSend = {
fromAddress: faucetAddress,
toAddress: emptyAddress,
amount: coins(1234, "ucosm"),
};
const msgAny = {
typeUrl: "/cosmos.bank.v1beta1.MsgSend",
value: msgSend,
};
// Broadcast and sign the transaction
const broadcastResult = await client.signAndBroadcast(
faucetAddress,
[msgAny],
defaultFee,
memo,
);
The above code shows you the use of the API and various objects and is a great way to learn how to embed CosmJS into your project. However, if you just want a cli to perform some quick queries on a chain, you can use an extended set of helpers:
Start with ./bin/cslir --init examples/helpers.ts
(This points to the Demonet at https://lcd.demo-08.cosmwasm.com for ease of use. Other networks, look below)
Setup Account:
// you can hand-copy a mnemonic here, but this is easiest for reuse between sessions
// it creates a random one first time, then reads it in the future
const mnemonic = loadOrCreateMnemonic("foo.key");
const { address, client } = await connect(mnemonic, {});
address;
client.getAccount();
// if empty - this only works with CosmWasm
hitFaucet(defaultFaucetUrl, address, "COSM");
client.getAccount();
View contracts:
// show all code and contracts
client.getCodes();
// query the first contract for first code
const contracts = await client.getContracts(1);
contracts;
const info = await client.getContract(contracts[0].address);
info;
info.initMsg;
// see your balance here
client.queryContractSmart(addr, { balance: { address } });
Instantiate and use ERC20 contract:
// no money? no problem.
// let's make our own s**coin - replace "FOO" with something else to avoid duplicates
const initMsg = {
name: "Foo Coin",
symbol: "FOO",
decimals: 2,
initial_balances: [{ address, amount: "123456789" }],
};
const foo = await client.instantiate(1, initMsg, "FOO");
foo;
foo.logs[0].events[0];
const fooAddr = foo.contractAddress;
// we can also find this another way...
const fooAddr2 = await client
.getContracts(1)
.then(
(contracts) =>
contracts.filter((x) => x.label == "FOO").map((x) => x.address)[0],
)[(fooAddr, fooAddr2)];
// now we have some cash
client.queryContractSmart(fooAddr, { balance: { address } });
const rcpt = await randomAddress("cosmos");
rcpt;
client.queryContractSmart(fooAddr, { balance: { address: rcpt } });
const execMsg = { transfer: { recipient: rcpt, amount: "808" } };
const exec = await client.execute(fooAddr, execMsg);
exec;
exec.logs[0].events[0];
client.queryContractSmart(fooAddr, { balance: { address: rcpt } });
Or just send tokens:
client.getAccount(rcpt);
const sent = await client.sendTokens(rcpt, [
{ amount: "1234", denom: "ucosm" },
]);
sent;
foo.logs[0].events[0];
All the network info can be configured inside the last argument to connect. To
see how to connect to the Regen Testnet, try this. (Note you need to use
.editor
in the repl to allow multi-line commands. Alternative is to place
entire regenOptions
on one line.
Run ./bin/cslir --init examples/helpers.ts
.editor
const regenOptions = {
httpUrl: "https://regen-lcd.vitwit.com/",
networkId: "kontraua",
feeToken: "utree",
gasPrice: 0.025,
bech32prefix: "xrn:",
}
^D
const mnemonic = loadOrCreateMnemonic("regen.key");
const {address, client} = await connect(mnemonic, regenOptions);
address
// check some random genesis account
client.getAccount("xrn:1pdfr7xuckj6lhdphdde6peres9ufwgpsv87mag")
// your own account is undefined unless you did this before
client.getAccount()
Hit the faucet with your address (in browser): https://regen.vitwit.com/faucet then continue in node
// should have tokens now
client.getAccount();
At this point you can continue all the other behaviors from above, looking at
codes, etc. Do note that the ERC contract is code 5
on this network (instead
of 1
above).
wasmcli
If you are using the go commands and have tokens there, you may want to reuse the same account. (If you don't know what this is, just skip this section). You can reuse the mnemonic between the Go tooling and the Node.js tooling, but this violates all security protocols - only use this for testnets. In the future we will offer proper encrypted key management for CosmJS.
(You can replace wasmcli
with xrncli
and use regenOptions
if you wish to
use that testnet)
Create a new key - note mnemonic and address
$ wasmcli keys add demo2
- name: demo2
type: local
address: cosmos1d4ut3z9c0kplgz5ma9t6ee637tagjqfyu4sxyl
pubkey: cosmospub1addwnpepqtagg2smk2zvj77xaslej2wevwz7jft0q5hj5yuwvek3r6z0ufjtxnde4rq
mnemonic: ""
threshold: 0
pubkeys: []
**Important** write this mnemonic phrase in a safe place.
It is the only way to recover your account if you ever forget your password.
cousin nephew vintage label empty sunny cargo mushroom photo side clarify sleep solid entire deal tattoo vehicle record discover arrive sting staff salt uncle
Save mnemonic to a file:
echo "cousin nephew vintage label empty sunny cargo mushroom photo side clarify sleep solid entire deal tattoo vehicle record discover arrive sting staff salt uncle" > wasmcli.key
Load it up in CosmJS: ./bin/cslir --init examples/helpers.ts
const mnemonic = loadOrCreateMnemonic("wasmcli.key");
const { address, client } = await connect(mnemonic, regenOptions);
// this should match what you got on the cli - showing compatibility
address;
Once you have access to the same key as in the cli, you can use those tokens to play with contracts.
Check out the mask documentation to view how to use some custom helpers to upload code and use non-trivial contracts with proper types.
This package is part of the CosmJS repository, licensed under the Apache License 2.0 (see NOTICE and LICENSE).
FAQs
a REPL connecting to Cosmos blockchains using the @cosmjs suite of libraries
We found that @csli/repl demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
ESLint has added JSON and Markdown linting support with new officially-supported plugins, expanding its versatility beyond JavaScript.
Security News
Members Hub is conducting large-scale campaigns to artificially boost Discord server metrics, undermining community trust and platform integrity.
Security News
NIST has failed to meet its self-imposed deadline of clearing the NVD's backlog by the end of the fiscal year. Meanwhile, CVE's awaiting analysis have increased by 33% since June.