---
# System prepended metadata

title: Asset Onboard CLI Instructions

---

# Asset Onboard CLI Instructions

## Generate testnet account / BIP39 mnemonic

*NOTE: This section can be skipped if you already have a BIP39 mnemonic and an account funded with `hash`.*

### Requirements:

* Node.JS >=v14.17.0

### Instructions:

Install cavendish (includes a `provenanced` CLI client):
```shell=
$ npm install @provenanceio/cavendish
```

Generate an account from a new BIP39 mnemonic:
```shell=
$ npx provenanced keys add testkey1 --testnet
```

```shell=
**Important** write this mnemonic phrase in a safe place.
It is the only way to recover your account if you ever forget your password.

palace eagle track orient sweet arctic tip audit genuine nothing maximum know bag addict crew seven antique beef spring media clock rich brief twist
- name: testkey1
  type: local
  address: tp1w9lh7w9r2askddmwdspuagzxt76r58yp0mks3y
  pubkey: '{"@type":"/cosmos.crypto.secp256k1.PubKey","key":"A8LVoyHa3Xs8NOh+1hMxekmm7aTIjCf5bHIf13XYDASJ"}'
  mnemonic: ""
```

Get some test `hash` token from the testnet faucet by visiting https://explorer.test.provenance.io/faucet and entering your account address:

![](https://i.imgur.com/jiVpkES.png)


## Onboard asset in pio-testnet-1

### Requirements:

* macOS Big Sur or later
* Java runtime >=v11.0.8

### Instructions

To onboard an asset on the Provenance testnet blockchain:

```shell=
$ asset-onboard-cli.sh onboard <ASSET_FILE> \
    --key-mnemonic "<BIP39_MNEMONIC>" \
    --chain-id pio-testnet-1 \
    --node http://34.148.39.82:9090 \
    --onboard-uri https://test.figure.tech/service-asset-onboarding \
    --api-key <API_KEY> \
    --testnet
```
```shell=
Requestor key address tp1wh62rv7svluppj5ly3crnp0a9gr6xvfztj9e3y
Requestor public key AuxYldxOozOnmw0bA87N+q9myn+gaGBkRxjT3NT435Ge
Onboarding NFT...
TX (height: 0, txhash: 67C2003D575D2B255382D42CAD659075C45EB7547803B306DB3C940091C11FAA, code: 0, gasWanted: 0, gasUsed: 0)
--------
View transaction on Provenance explorer here:
https://explorer.test.provenance.io/tx/67C2003D575D2B255382D42CAD659075C45EB7547803B306DB3C940091C11FAA
```

Replace the placeholders with your own values:

| Placeholder    | Description                                  |
| -------------- | -------------------------------------------- |
| ASSET_FILE     | The path to your asset.                      |
| BIP39_MNEMONIC | Your BIP39 mnemonic phrase.                  |
| API_KEY        | Your `service-asset-onboarding` test API key.|
