Skip to content

Commit

Permalink
docs: Update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
duanyytop committed Jan 10, 2025
1 parent 4520b51 commit 6002587
Showing 1 changed file with 55 additions and 0 deletions.
55 changes: 55 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,57 @@
# typeid-contract-cell-deps

The cell deps of the CKB contracts deployed by TypeID

## Cell Deps APIs

All the supported cellDeps can be fetched with the following Get HTTP request:

```
curl -X GET "https://typeid-contract-cell-deps.vercel.app/api/cell-deps"
```

If you want to filter specific cellDeps, append query parameters directly to the URL:

```
curl -X GET "https://typeid-contract-cell-deps.vercel.app/api/filter-cell-deps?xudt=false&compatibleUdtCodeHashes=0x1142755a044bf2ee358cba9f2da187ce928c91cd4dc8692ded0337efa677d21a,0x26a33e0815888a4a0614a0b7d09fa951e0993ff21e55905510104a0b1312032b"
```

- **rgbpp**: boolean, true means included, false means not included
- **btcTime**: boolean, true means included, false means not included
- **xudt**: boolean, true means included, false means not included
- **unique**: boolean, true means included, false means not included
- **tokenMetadata**: boolean, true means included, false means not included
- **utxoAirdropBadge**: boolean, true means included, false means not included
- **compatibleUdtCodeHashe**s: string, a comma-separated string to represent code hash array

All the cellDeps will be cached for 10 ~ 60 seconds, and the cache detail can be found [here](./api/cell-deps.ts).

## Compatible xUDT TypeId deployment information

A fungible token that is fully compatible with xUDT can directly submit the deployment information of the mainnet and testnet in the [compatible-udt.json](./compatible-udt.json) file, and the API response will return the cellDep of the asset.

**Anyone can create a GitHub Pull Request to add his/her fully-compatible-xUDT TypeId deployment information**

**Feel free to submit your token information**

The fully-compatible-xUDT JSON format is like this:

```
{
"_description": "RUSD testnet code hash and deployment type script args",
"_udt_link": "https://testnet.explorer.nervos.org/xudt/0x45b32a2bc4285d0a09678eb11960ddc8707bc2779887a09d482e9bfe9a2cdf52",
"_deployment_link": "https://testnet.explorer.nervos.org/transaction/0xed7d65b9ad3d99657e37c4285d585fea8a5fcaf58165d54dacf90243f911548b#0",
"network": "testnet",
"codeHash": "0x1142755a044bf2ee358cba9f2da187ce928c91cd4dc8692ded0337efa677d21a",
"deploymentTypeArgs": "0x97d30b723c0b2c66e9cb8d4d0df4ab5d7222cbb00d4a9a2055ce2e5d7f0d8b0f"
}
```
### Annotative Optional Fields
- _description: The compatible-xUDT token description
- _udt_link: The compatible-xUDT token detail link of the CKB Explorer
- _deployment_link: The compatible-xUDT token deployment transaction detail link of the CKB Explorer

### Required Fields
- **network**: testnet or mainnet for Nervos CKB
- **codeHash**: The compatible-xUDT token code hash
- **deploymentTypeArgs**: The compatible-xUDT token deployment transaction output type script args

0 comments on commit 6002587

Please sign in to comment.