- 0.10.11Latest
- 0.10.10
- 0.10.9
- 0.10.9
- 0.10.8
- 0.10.8
- 0.10.7
- 0.10.6
- 0.10.5
- 0.10.4
- 0.10.3
- 0.10.2
- 0.10.1
- 0.10.0
- 0.9.8
- 0.9.7
- 0.9.6
- 0.9.6
- 0.9.5
- 0.9.5
- 0.9.4
- 0.9.4
- 0.9.3
- 0.9.2
- 0.9.1
- 0.9.0
- 0.8.9
- 0.8.8
- 0.8.7
- 0.8.6
- 0.8.5
- 0.8.4
- 0.8.3
- 0.8.2
- 0.8.1
- 0.8.0
- 0.7.9
- 0.7.8
- 0.7.7
- 0.7.6
- 0.7.5
- 0.7.4
- 0.7.3
- 0.7.2
- 0.7.1
- 0.7.0
- 0.6.9
- 0.6.8
- 0.6.7
- 0.6.6
- 0.6.5
- 0.6.4
- 0.6.3
- 0.6.2
- 0.6.1
- 0.6.0
- 0.5.9
- 0.5.8
- 0.5.7
- 0.5.6
- 0.5.5
- 0.5.4
- 0.5.3
- 0.5.2
- 0.5.1
- 0.5.0
Lucid
Lucid is a library, which allows you to create Cardano transactions and off-chain code for your Plutus contracts in JavaScript, Deno and Node.js.
Get started
NPM
npm install lucid-cardano
Deno 🦕
For JavaScript and TypeScript
import { Lucid } from "https://deno.land/x/lucid@0.9.4/mod.ts";
Web
<script type="module">
import { Lucid } from "https://unpkg.com/lucid-cardano@0.9.4/web/mod.js"
// ...
</script>
Build from source
Build NPM and Web target
deno task build
Outputs a dist
folder
Examples
Basic usage
// import { Blockfrost, Lucid } from "https://deno.land/x/lucid@0.9.4/mod.ts"; Deno
import { Blockfrost, Lucid } from "lucid-cardano"; // NPM
const lucid = await Lucid.new(
new Blockfrost("https://cardano-preview.blockfrost.io/api/v0", "<projectId>"),
"Preview",
);
// Assumes you are in a browser environment
const api = await window.cardano.nami.enable();
lucid.selectWallet(api);
const tx = await lucid.newTx()
.payToAddress("addr...", { lovelace: 5000000n })
.complete();
const signedTx = await tx.sign().complete();
const txHash = await signedTx.submit();
console.log(txHash);
Test
deno task test
Docs
You can generate documentation with:
deno doc
Compatibility
Lucid is an ES Module, so to run it in the browser any bundler which allows for
top level await and WebAssembly is recommended. If you use Webpack 5 enable in
the webpack.config.js
:
experiments: {
asyncWebAssembly: true,
topLevelAwait: true,
layers: true // optional, with some bundlers/frameworks it doesn't work without
}
To run the library in Node.js you need to set {"type" : "module"}
in your
project’s package.json
. Otherwise you will get import issues.
This library is built on top of a customized version of the serialization-lib (cardano-multiplatform-lib) and on top of the message-signing library.
cardano-multiplatform-lib
Link: https://github.com/Berry-Pool/cardano-multiplatform-lib/tree/vasil
Branch: vasil
Commit hash: a0a089b393c760bbcf95e0d3f68d96a17e1e6de8
message-signing
Link: https://github.com/Emurgo/message-signing
Branch: master
Commit hash: 16dcadc69557dd7c20e62a966aaded1e051c287e
Contributing
Contributions and PRs are welcome!
The contribution instructions.
Join us on Discord!
Use Lucid with React
use-cardano a React context, hook and set of components built on top of Lucid
Use Lucid with Next.js
Cardano Starter Kit a Next.js starter kit for building Cardano dApps