> ## Documentation Index
> Fetch the complete documentation index at: https://cobo.com/developers/llms.txt
> Use this file to discover all available pages before exploring further.
# Get started with JavaScript SDK
> Learn to integrate, configure, and use the JavaScript SDK with code samples for seamless app development.
Try [Cobo WaaS Skill](/v2/guides/overview/cobo-waas-skill) in your AI coding assistant (Claude Code, Cursor, etc.). Describe your needs in natural language to auto-generate production-ready SDK code and debug faster 🚀
## Overview
This guide introduces how to get started with using the Cobo WaaS 2.0 JavaScript SDK, which allows you to integrate the WaaS service into your existing application using the JavaScript programming language.
To learn more about the initial setup steps necessary for utilizing the WaaS API, see [Send your first request](/v2/guides/get-started/get-started-with-waas).
You can go to [GitHub](https://github.com/CoboGlobal/cobo-waas2-js-sdk/) to access the source code of the SDK.
## Prerequisites
* Install Node.js and NPM.
* Follow the instructions in [Set up your account and organization](https://manuals.cobo.com/en/portal/quick-start-guide) to set up your Cobo account and create your organization. If an organization has already been set up, ask your organization admin to invite you to join the organization.
* You have [generated an API key and an API secret](/v2/guides/overview/cobo-auth#generate-an-api-key-and-an-api-secret), and [registered the API key](https://manuals.cobo.com/en/portal/developer-console/create-api-key) on Cobo Portal.
## Create a project and install the SDK
1. Create a project directory and initialize NPM:
```bash theme={null}
mkdir waas2-js && cd waas2-js
npm init -y
```
2. Install the SDK:
```bash theme={null}
npm install @cobo/cobo-waas2 --save
```
The directory structure after installation is as follows:
```pgsql theme={null}
waas2-js/
├─ node_modules/
├─ package.json
├─ package-lock.json
└─ (to be created later) index.js
```
If your project already has package.json and package-lock.json, you can directly copy them to the root directory and run npm install to pull dependencies.
3. Create a file index.js in the root directory and paste the following code into it.
The directory structure after installation is as follows:
```pgsql theme={null}
waas2-js/
├─ node_modules/
├─ package.json
├─ package-lock.json
└─ (to be created later) index.js
```
If your project already has package.json and package-lock.json, you can directly copy them to the root directory and run npm install to pull dependencies.
3. Create a file index.js in the root directory and paste the following code into it.
## Configure API key and HTTP host
1. Set the API secret.
```javascript theme={null}
// Initialize the default API client
const apiClient = CoboWaas2.ApiClient.instance
// Set the API secret
apiClient.setPrivateKey("");
```
2. Select which [environment](/v2/guides/overview/environments) you want to use.
```javascript theme={null}
// Select the development environment
apiClient.setEnv(CoboWaas2.Env.DEV);
// Select the production environment
apiClient.setEnv(CoboWaas2.Env.PROD);
```
## Code sample
For operation-specific documentation and sample code, see the [docs](https://github.com/CoboGlobal/cobo-waas2-js-sdk/tree/master/docs) folder in the WaaS SDK GitHub repository.
### List supported chains
```javascript theme={null}
const CoboWaas2 = require("@cobo/cobo-waas2");
// Initialize the API client
const apiClient = CoboWaas2.ApiClient.instance;
// Set the environment (development: Env.DEV, production: Env.PROD)
apiClient.setEnv(CoboWaas2.Env.DEV);
// Configure API Secret – replace with your API Secret
apiClient.setPrivateKey("");
// Create a WalletsApi instance
const apiInstance = new CoboWaas2.WalletsApi();
// Define query parameters
const opts = {
wallet_type: "Custodial", // Wallet type: Custodial wallet
wallet_subtype: "Asset", // Wallet subtype: Asset wallet
chain_ids: "BTC,ETH", // Chain IDs to query: BTC, ETH
limit: 10, // Limit the number of results to 10 entries
before: "RqeEoTkgKG5rpzqYzg2Hd3szmPoj2cE7w5jWwShz3C1vyGmk1", // For pagination, optional
after: "RqeEoTkgKG5rpzqYzg2Hd3szmPoj2cE7w5jWwShz3C1vyGSAk", // For pagination, optional
};
// Call the API to list supported chains
apiInstance.listSupportedChains(opts).then(
(data) => {
console.log("API called successfully. Returned data: " + data);
},
(error) => {
console.error(error);
},
);
```
Example response is as follows:
```javascript theme={null}
API called successfully. Returned data: {
"data": [
{
"chain_id": "BTC",
"symbol": "Bitcoin",
"icon_url": "https://d.cobo.com/public/logos/btc%403x.png",
"explorer_tx_url": "https://mempool.space/tx/{txn_id}",
"explorer_address_url": "https://mempool.space/address/{address}",
"require_memo": false,
"confirming_threshold": 4
},
{
"chain_id": "ETH",
"symbol": "Ethereum",
"icon_url": "https://d.cobo.com/public/logos/eth%403x.png",
"explorer_tx_url": "https://etherscan.io/tx/{txn_id}",
"explorer_address_url": "https://etherscan.io/address/{address}",
"require_memo": false,
"confirming_threshold": 64
}
],
"pagination": {
"before": "",
"after": "",
"total_count": 2
}
}
```
### Create a wallet
```javascript theme={null}
const CoboWaas2 = require("@cobo/cobo-waas2");
// Initialize the API client
const apiClient = CoboWaas2.ApiClient.instance;
// Set the environment (development: Env.DEV, production: Env.PROD)
apiClient.setEnv(CoboWaas2.Env.DEV);
// Configure API Secret – replace with your API Secret
apiClient.setPrivateKey("");
// Create a WalletsApi instance
const apiInstance = new CoboWaas2.WalletsApi();
// Define parameters for wallet creation
const opts = {
CreateWalletParams: CoboWaas2.CreateWalletParams.constructFromObject({
name: "My WaaS 2.0 Wallet", // Wallet name
wallet_type: "Custodial", // Wallet type: Custodial Wallets
wallet_subtype: "Asset", // Wallet subtype: Asset Wallets
}),
};
// Call the API to create a wallet
apiInstance.createWallet(opts).then(
(data) => {
console.log("API called successfully. Returned data: " + data);
},
(error) => {
console.error(error);
},
);
```