Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
39 commits
Select commit Hold shift + click to select a range
2d15224
plutarch - haskell label
0xBora Nov 8, 2025
ae2c906
add new tools
0xBora Nov 8, 2025
1fa0716
plu-ts -> pebble
0xBora Nov 8, 2025
b427a7a
domain filters first
0xBora Nov 8, 2025
24defe3
plutus tag removed, smartcontracts filter introduced
0xBora Nov 8, 2025
94da39b
builder tools extend wallet filter
0xBora Nov 8, 2025
5c2f50e
add bursa
0xBora Nov 8, 2025
c129642
add cardano-dev-wallet
0xBora Nov 8, 2025
799dcf6
add cardano-hw-cli
0xBora Nov 8, 2025
ff550df
add cardano-peer-connect
0xBora Nov 8, 2025
f6c5039
add cardanopress
0xBora Nov 8, 2025
b50b81c
add cshell
0xBora Nov 8, 2025
a091110
add sorbet
0xBora Nov 8, 2025
4978356
add p2p-wallet
0xBora Nov 8, 2025
94b0195
chore: smart contract lang images to builder tools
0xBora Nov 8, 2025
32d039a
update kuber
0xBora Nov 8, 2025
7fa2245
add nmkr-studio
0xBora Nov 8, 2025
a607bae
rework filters
0xBora Nov 8, 2025
348b83b
refactor: reorganize builder-tools folder structure
0xBora Nov 8, 2025
823cdfb
remove unused images
0xBora Nov 8, 2025
da803d9
remove workspace config - packages directory does not exist
0xBora Nov 8, 2025
08c1ec7
remove unused typescript
0xBora Nov 8, 2025
a66a0c3
remove seperate variables file & merge into docusaurus config
0xBora Nov 8, 2025
4442e80
remove empty devDependencies
0xBora Nov 8, 2025
d27effb
remove duplicate developers text from navbar
0xBora Nov 8, 2025
5580c16
add your tool component redirect
0xBora Nov 8, 2025
20d95dd
Move community files to docs/community directory & add redirects
0xBora Nov 8, 2025
d67f1a3
Move technical concepts and educational resources to docs/learn
0xBora Nov 9, 2025
94433a1
eorganize networks and infrastructure into proper subdirectories
0xBora Nov 9, 2025
59dc6ea
move node operations
0xBora Nov 9, 2025
cc90731
move client-sdks / infrastructure
0xBora Nov 9, 2025
829264e
move integrate
0xBora Nov 9, 2025
f742edf
move native tokens
0xBora Nov 9, 2025
0fc5235
move transaction metadata
0xBora Nov 9, 2025
d0d5b2f
move smart contracts & fix broken links & redirects
0xBora Nov 9, 2025
b14afb3
move items & fix broken links
0xBora Nov 9, 2025
dfc22b4
move utxos to integrate wallet auth
0xBora Nov 9, 2025
fe139a9
Merge branch 'staging' into docs-update-2
0xBora Nov 9, 2025
96bb72a
update navbar links
0xBora Nov 10, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
41 changes: 23 additions & 18 deletions .github/PULL_REQUEST_TEMPLATE/builder-tool.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,44 +9,49 @@
<-- Please fill the boxes with [x] before submitting a pull request -->

- [ ] I have read the [Contributing Guidelines](https://github.com/cardano-foundation/developer-portal/blob/staging/CONTRIBUTING.md).
- [ ] I have read the [Builder Tool Requirements](https://github.com/cardano-foundation/developer-portal/edit/staging/src/data/builder-tools.js)
- [ ] I have run `yarn build` after adding my changes **without getting any errors**.
- [ ] I have read the [Builder Tool Requirements](https://github.com/cardano-foundation/developer-portal/edit/staging/src/data/builder-tools/tools.js)
- [ ] I have added my image to `src/data/builder-tools/images/`
- [ ] I have run `yarn build` after adding my changes **without getting any errors**.
- [ ] I have not committed any changes to `yarn.lock` (or have [removed these changes](https://github.com/cardano-foundation/developer-portal/blob/staging/CONTRIBUTING.md#faq)).

## Builder Tool addition

<-- Provide information for every bullet in the list below. The tags you select must match the tags in your changes to the builder-tools.js -->
<-- Provide information for every bullet in the list below. The tags you select must match the tags in your changes to tools.js -->

* Title: *Project name*
* Description: *Describe your project*
* Website: <link_to_project>
* Getstarted: <link_to_getstarted_page>
* Tags:
* `chainindex`
* `c`
* `cli`
* `elm`
* `golang`
* `governance`
* `haskell`
* `hosted`
* `http`
* `IDE`
* `indexer`
* `java`
* `javascript`
* `marlowe`
* `json`
* `net`
* `nft`
* `nodeclient`
* `operatortool`
* `oracle`
* `plutus`
* `php`
* `provider`
* `purescript`
* `python`
* `redis`
* `rust`
* `purescript`
* `websocket`
* `http`
* `json`
* `haskell`
* `typescript`
* `wallet`
* `scala`
* `serialization`
* `sdk`
* `redis`
* `smartcontracts`
* `sql`
* `lowlevel`
* `testing`
* `hosted`
* `transactionbuilder`
* `typescript`
* `wallet`
* `websocket`
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ First of all, thank you for taking the time to contribute!🎉👍

### Add to Builder Tools

- See inline instructions in [src/data/builder-tools.js](https://github.com/cardano-foundation/developer-portal/blob/staging/src/data/builder-tools.js)
- See inline instructions in [src/data/builder-tools/tools.js](https://github.com/cardano-foundation/developer-portal/blob/staging/src/data/builder-tools/tools.js)
- Requirements: Helps Cardano developers, stable domain, functional
- Use the "Add Builder Tool" GitHub PR template

Expand Down
4 changes: 2 additions & 2 deletions blog/2021-08-09-nft-minting-standard.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,12 +28,12 @@ To read more about CIP 721 and the NFT Metadata Standard, click [here](https://g

**How we minted the NFTAs**

Tokens that are built on Cardano are native. Unlike Ethereum’s ERC-20 tokens, Cardano doesn’t require a smart contract. Instead, the tokens are treated like Cardano’s native token, ADA. Using native tokens, you can create a variety of digital assets like Non-Fungible-Tokens representing art or appreciation. Learn more about this [here](../docs/native-tokens/).
Tokens that are built on Cardano are native. Unlike Ethereum’s ERC-20 tokens, Cardano doesn’t require a smart contract. Instead, the tokens are treated like Cardano’s native token, ADA. Using native tokens, you can create a variety of digital assets like Non-Fungible-Tokens representing art or appreciation. Learn more about this [here](/docs/build/native-tokens/overview).

To make sure the NFTAs came from the Cardano Foundation, a **policyId** identifies them. You can check out more information about the NFTAs and the **policyId** at the [Cardano Foundation NFTA Official Page](https://cardanofoundation.org/nfta). In addition, they are attached with [metadata](https://pool.pm/2783ee3048c5158646674def386e8610ce2c8824e515451baa4769a6.CFNFTA01) that describes the details of the transaction and ownership address.

To mint the NFT’s, we first used a Cardano Foundation wallet to create a transaction to mint the tokens containing the metadata. Second, the ten developers sent us a receiving wallet address to receive the token. Third, another transaction to send the token to their wallet. Finally, to verify the work, each NFTA has a QR code that will navigate to the [Cardano Blockchain Explorer](https://explorer.cardano.org/en/address.html?address=addr1v8jad20nlga6ca7vjtqs2pr8cu0tcq3rq8s6svm546rvyjggl5yh7) for anyone to view and verify the transactions, including the Bronze Developer Portal Token issuance. Thus, no matter how much time goes by, the blockchain will have an immutable record to show that the community members received the first Non-Fungible Token of Appreciation.

![title image](/img/devblog/how-to-mint.png)

At the time of writing this article, two NFTs have not been minted. We are waiting on two developers to provide their wallet addresses. Also, the Cardano Explorer is not showing the transactions correctly when you try to scan the QR code on the NFTAs. If you are interested in learning more or mint native assets or NFTs, visit the [Cardano Developer Portal](../docs/native-tokens/).
At the time of writing this article, two NFTs have not been minted. We are waiting on two developers to provide their wallet addresses. Also, the Cardano Explorer is not showing the transactions correctly when you try to scan the QR code on the NFTAs. If you are interested in learning more or mint native assets or NFTs, visit the [Cardano Developer Portal](/docs/build/native-tokens/overview).
2 changes: 1 addition & 1 deletion blog/2023-03-21-march.md
Original file line number Diff line number Diff line change
Expand Up @@ -101,7 +101,7 @@ We are working closely with [Gimbalabs](https://gimbalabs.io/), [Harmonic Labs](

**_How can someone interested in Mesh find out more about it?_**

You can stay updated on the latest Mesh development by following [@meshsdk](https://twitter.com/meshsdk) on Twitter. If you want to start building on Cardano, check out our [guides](https://meshjs.dev/guides), our guides in the [developer portal](../docs/get-started/mesh/overview), and [start building](https://meshjs.dev/apis).
You can stay updated on the latest Mesh development by following [@meshsdk](https://twitter.com/meshsdk) on Twitter. If you want to start building on Cardano, check out our [guides](https://meshjs.dev/guides), our guides in the [developer portal](/docs/get-started/client-sdks/typescript/mesh/overview), and [start building](https://meshjs.dev/apis).

Here are some of our links:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -36,4 +36,4 @@ Visit [docs.charli3.io](https://docs.charli3.io/oracles) for:

---

**Related**: [Orcfax](/docs/integrate-cardano/orcfax) | [Oracles Overview](/docs/integrate-cardano/oracles-overview)
**Related**: [Orcfax](/docs/build/integrate/oracles/orcfax) | [Oracles Overview](/docs/build/integrate/oracles/overview)
Original file line number Diff line number Diff line change
Expand Up @@ -53,4 +53,4 @@ Explore available feeds on the [Orcfax Explorer](https://explorer.orcfax.io).

---

**Related**: [Charli3](/docs/integrate-cardano/charli3) | [Oracles Overview](/docs/integrate-cardano/oracles-overview)
**Related**: [Charli3](/docs/build/integrate/oracles/charli3) | [Oracles Overview](/docs/build/integrate/oracles/overview)
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
id: oracles-overview
id: overview
title: Oracles on Cardano
sidebar_label: Overview
description: Learn about oracle services that bring real-world data to Cardano smart contracts.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,20 +1,19 @@
---
id: overview
slug: /integrate-cardano/
title: Integrate Cardano
sidebar_label: Overview
description: How to integrate Cardano into existing websites and services.
image: /img/og/og-developer-portal.png
---


![Integrate Cardano](../../static/img/card-integrate-cardano-title.svg)
![Integrate Cardano](/img/card-integrate-cardano-title.svg)

## Introduction
Here we show you how to integrate Cardano into existing websites and services.

## Integration Components
- [Overview](docs/operate-a-stake-pool/node-operations/cardano-components.md) of the different Cardano components.
- [Overview](/docs/get-started/infrastructure/node/cardano-components) of the different Cardano components.
- [cardano-node](https://github.com/IntersectMBO/cardano-node) is the top level for the node and aggregates the other components from other packages: consensus, ledger and networking, with configuration, CLI, logging and monitoring.
- [cardano-wallet](https://github.com/cardano-foundation/cardano-wallet) helps you manage ada. You can use it to send and receive payments on the Cardano blockchain via a http and cli interface.
- [cardano-db-sync](https://github.com/IntersectMBO/cardano-db-sync) follows the Cardano chain and takes information from the chain and an internally maintained copy of ledger state. Data is then extracted from the chain and inserted into a PostgreSQL database.
Expand All @@ -23,8 +22,8 @@ Here we show you how to integrate Cardano into existing websites and services.
- [cardano-addresses](https://github.com/IntersectMBO/cardano-addresses) provides mnemonic (backup phrase) creation, and conversion of a mnemonic to seed for wallet restoration, and address derivation functionalities.

## Tutorials
- [Listening for ada payments](listening-for-payments/overview) - learn different approaches to detect and confirm ada payments in your applications.
- [Testnet Faucet](testnet-faucet) - a service that provides test ada (tAda) to users of the Cardano testnets.
- [Listening for ada payments](payments/listening-for-payments/overview) - learn different approaches to detect and confirm ada payments in your applications.
- [Testnet Faucet](/docs/get-started/networks/testnets/testnet-faucet) - a service that provides test ada (tAda) to users of the Cardano testnets.
- [Sample queries](https://iohk.zendesk.com/hc/en-us/articles/4402395914009-Sample-cardano-rosetta-queries) for cardano-rosetta.
- [Sample queries](https://iohk.zendesk.com/hc/en-us/articles/900000906566-Sample-cardano-graphql-queries) for cardano-graphql.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,22 +17,22 @@ For a higher-level approach with less infrastructure, check out the [Point of Sa
## Overview

:::note
This guide assumes that you have basic understanding of `cardano-cli`, how to use it and that you have installed it into your system. Otherwise we recommend reading [Installing cardano-node](docs/operate-a-stake-pool/node-operations/installing-cardano-node.md), [Running cardano-node](/docs/operate-a-stake-pool/node-operations/running-cardano.md) and [Get started with Cardano CLI](/docs/get-started/cardano-cli/basic-operations/get-started) guides first.
This guide assumes that you have basic understanding of `cardano-cli`, how to use it and that you have installed it into your system. Otherwise we recommend reading [Installing cardano-node](/docs/get-started/infrastructure/node/installing-cardano-node), [Running cardano-node](/docs/get-started/infrastructure/node/running-cardano.md) and [Get started with Cardano CLI](/docs/get-started/infrastructure/cardano-cli/basic-operations/get-started) guides first.

This guide also assumes that you have `cardano-node` running in the background and connected to a [testnet network](docs/get-started/testnets-and-devnets.md).
This guide also assumes that you have `cardano-node` running in the background and connected to a [testnet network](/docs/get-started/networks/testnets/overview).
:::

## Use case

There are many possible reasons why you would want to have the functionality of listening for `ada` payments, but a very obvious use case would be for something like an **online shop** or a **payment gateway** that uses `ada` tokens as the currency.

![img](../../../static/img/integrate-cardano/ada-online-shop.png)
![img](/img/integrate-cardano/ada-online-shop.png)

## Technical flow

To understand how something like this could work in a technical point of view, let's take a look at the following diagram:

![img](../../../static/img/integrate-cardano/ada-payment-flow.png)
![img](/img/integrate-cardano/ada-payment-flow.png)

So let's imagine a very basic scenario where a **customer** is browsing an online shop. Once the user has chosen and added all the items into the **shopping cart**, the next step would then be to checkout and pay for the items. Of course we will be using **Cardano** for that!

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,23 +18,23 @@ For a simpler approach without running any blockchain infrastructure, check out

:::note

This guide assumes that you have basic understanding of `cardano-wallet`, how to use it and that you have installed it into your system. Otherwise we recommend reading [Installing cardano-node](docs/operate-a-stake-pool/node-operations/installing-cardano-node.md), [Running cardano-node](/docs/operate-a-stake-pool/node-operations/running-cardano.md), [Installing cardano-wallet](/docs/get-started/cardano-wallet/cardano-wallet) and [Using cardano-wallet](/docs/get-started/cardano-wallet/using-cardano-wallet) guides first.
This guide assumes that you have basic understanding of `cardano-wallet`, how to use it and that you have installed it into your system. Otherwise we recommend reading [Installing cardano-node](/docs/get-started/infrastructure/node/installing-cardano-node), [Running cardano-node](/docs/get-started/infrastructure/node/running-cardano.md), [Installing cardano-wallet](/docs/get-started/infrastructure/cardano-wallet/cardano-wallet) and [Using cardano-wallet](/docs/get-started/infrastructure/cardano-wallet/using-cardano-wallet) guides first.

This guide also assumes that you have `cardano-node` and `cardano-wallet` running in the background and connected to a [testnet network](docs/get-started/testnets-and-devnets.md).
This guide also assumes that you have `cardano-node` and `cardano-wallet` running in the background and connected to a [testnet network](/docs/get-started/networks/testnets/overview).

:::

## Use case

There are many possible reasons why you would want to have the functionality of listening for `ada` payments, but a very obvious use case would be for something like an **online shop** or a **payment gateway** that uses `ada` tokens as the currency.

![img](../../../static/img/integrate-cardano/ada-online-shop.png)
![img](/img/integrate-cardano/ada-online-shop.png)

## Technical flow

To understand how something like this could work in a technical point of view, let's take a look at the following diagram:

![img](../../../static/img/integrate-cardano/ada-payment-flow-wallet.png)
![img](/img/integrate-cardano/ada-payment-flow-wallet.png)

So let's imagine a very basic scenario where a **customer** is browsing an online shop. Once the user has chosen and added all the items into the **shopping cart**. The next step would then be to checkout and pay for the items, Of course we will be using **Cardano** for that!

Expand Down Expand Up @@ -203,7 +203,7 @@ var resp = await http.PostAsJsonAsync("wallets", new {

#### Get unused wallet address to receive some payments

We will get a **wallet address** to show to the customers and for them to send payments to the wallet. In this case we can use the address to request some `tAda` from the [Cardano Testnet Faucet](../testnet-faucet) and simulate a payment:
We will get a **wallet address** to show to the customers and for them to send payments to the wallet. In this case we can use the address to request some `tAda` from the [Cardano Testnet Faucet](/docs/get-started/networks/testnets/testnet-faucet) and simulate a payment:

<Tabs
defaultValue="js"
Expand Down Expand Up @@ -592,7 +592,7 @@ The code is telling us that our current wallet has received a total of `0 lovela

What we can do to simulate a successful payment is to send at least `1,000,000 lovelace` into the **wallet address** that we have just generated for this project. We show how you can get the **wallet address** via code in the examples above.

Now simply send at least `1,000,000 lovelace` to this **wallet address** or request some `test ada` funds from the [Cardano Testnet Faucet](../testnet-faucet). Once complete, we can now run the code again and we should see a successful result this time.
Now simply send at least `1,000,000 lovelace` to this **wallet address** or request some `test ada` funds from the [Cardano Testnet Faucet](/docs/get-started/networks/testnets/testnet-faucet). Once complete, we can now run the code again and we should see a successful result this time.

<Tabs
defaultValue="js"
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -32,4 +32,4 @@ The basic payment detection flow:
4. **Verify amount** - Confirm received amount matches expected payment
5. **Complete transaction** - Fulfill order/service once payment is confirmed

![Payment Flow](../../../static/img/integrate-cardano/ada-online-shop.png)
![Payment Flow](/img/integrate-cardano/ada-online-shop.png)
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ This is the quickest way to get a production-ready payment system running. No bl

Welcome to the documentation of a Point of Sale (POS) application built using Cardano APIs. This guide will walk you through the key features and functionalities of the application.

![Point Of Sale](../../../static/img/integrate-cardano/point-of-sale-example.png)
![Point Of Sale](/img/integrate-cardano/point-of-sale-example.png)

### Getting Started

Expand Down Expand Up @@ -76,7 +76,7 @@ Please refer to `.env.example` in the repo and create `.env.local` file. Your ke
2. Once you're signed in, navigate to your dashboard.
3. Click on "Add new Project" to create a new project.
4. Choose the Cardano network you want to use. -->
1. Please follow [Get Started with Blockfrost](../../get-started/blockfrost/get-started.md) to obtain Blockfrost API key
1. Please follow [Get Started with Blockfrost](/docs/get-started/infrastructure/api-providers/blockfrost/get-started) to obtain Blockfrost API key
2. In the code, go to environment file `.env.local` and put the key into `BLOCKFROST_API_KEY`.


Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: Low-level implementation of wallet authentication using Cardano Ser
image: /img/og/og-developer-portal.png
---

This guide provides a low-level implementation of wallet-based authentication using the [Cardano Serialization Library](../../get-started/cardano-serialization-lib/overview) and [Cardano Message Signing](https://www.npmjs.com/package/@emurgo/cardano-message-signing-nodejs) libraries. This approach gives you direct control over COSE signature parsing and verification.
This guide provides a low-level implementation of wallet-based authentication using the [Cardano Serialization Library](/docs/get-started/client-sdks/low-level/cardano-serialization-lib/overview) and [Cardano Message Signing](https://www.npmjs.com/package/@emurgo/cardano-message-signing-nodejs) libraries. This approach gives you direct control over COSE signature parsing and verification.

## Overview

Expand Down Expand Up @@ -83,7 +83,7 @@ loadCsl();
...
```

With the above lines, we just made available to the rest of our script, the [Buffer](https://www.npmjs.com/package/buffer) package and the [Cardano Serialization Library](/docs/get-started/cardano-serialization-lib/overview). Also, we just declared the top-level variable `wallet` there for convenience later. We will set its value in the following steps.
With the above lines, we just made available to the rest of our script, the [Buffer](https://www.npmjs.com/package/buffer) package and the [Cardano Serialization Library](/docs/get-started/client-sdks/low-level/cardano-serialization-lib/overview). Also, we just declared the top-level variable `wallet` there for convenience later. We will set its value in the following steps.

Now, let's make the `authenticate` function actually do some things:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ The data on the NFC chip is encrypted using symmetric encryption keys, which mea

The process is depicted in here:

![img](../../static/img/native-tokens/nft-merch-store-poc.png)
![img](/img/native-tokens/nft-merch-store-poc.png)


:::tip
Expand Down
Loading
Loading