# nToken
The **nToken Contracts** represent receipt tokens issued to lenders when they provide assets to the Neptune Protocol. Each supported market asset has its own nToken contract that tracks lending positions and handles the distribution of lending yields.
## Available nTokens
***
## Overview
nTokens (Neptune Receipt Tokens) are CW20-compliant tokens that:
* Are minted when users deposit assets into Neptune lending markets
* Represent a user's share of the lending pool
* Automatically accumulate lending yields
* Can be used as collateral in Neptune markets
* Can be transferred between users while maintaining the underlying position
The redemption value of nTokens increases over time as lending interest accrues, allowing holders to redeem for more of the underlying asset than they initially deposited.
***
## Query Messages
### 1. Token Info
**Query:** `token_info`
**Purpose:**\
Retrieves basic information about the nToken including name, symbol, decimals, and total supply.
**Query Input:**
```json
{
"token_info": {}
}
```
**Query Response:**
```json
{
"name": "Neptune USDT",
"symbol": "nUSDT",
"decimals": 6,
"total_supply": "873600917508"
}
```
| Parameter | Type | Description |
| -------------- | --------- | ---------------------------------- |
| `name` | `string` | The name of the nToken |
| `symbol` | `string` | The symbol of the nToken |
| `decimals` | `u8` | Number of decimal places |
| `total_supply` | `unit256` | Current total supply of the nToken |
### 2. Balance
**Query:** `balance`
**Purpose:**\
Returns the nToken balance of a specified address.
**Query Input:**
```json
{
"balance": {
"address": "inj1..."
}
}
```
**Query Response:**
```json
{
"balance": "1000000"
}
```
| Parameter | Type | Description |
| --------- | --------- | ------------------------------------------- |
| `balance` | `unit128` | The nToken balance of the specified address |
***
## Execute Messages
### 1. Transfer
**Execute:** `transfer`
**Purpose:**\
Transfers nTokens from the sender to a specified recipient.
**Execute Input:**
```json
{
"transfer": {
"recipient": "inj1...",
"amount": "1000000"
}
}
```
| Parameter | Type | Description | Required |
| ----------- | --------- | ------------------------------ | -------- |
| `recipient` | `addr` | Address to receive the nTokens | Yes |
| `amount` | `unit128` | Amount of nTokens to transfer | Yes |
### 2. Send
**Execute:** `send`
**Purpose:**\
Transfers nTokens from the sender to a contract, triggering a receive hook on the receiving contract. This is used for operations like redeeming nTokens for the underlying asset through the Market contract.
**Execute Input:**
```json
{
"send": {
"contract": "inj1nc7gjkf2mhp34a6gquhurg8qahnw5kxs5u3s4u",
"amount": "1000000",
"msg": "eyJyZWRlZW0iOnt9fQ==" // Base64 encoded message: {"redeem":{}}
}
}
```
Parameter
Type
Description
Required
contract
addr
Contract address to receive the nTokens
Yes
amount
unit128
Amount of nTokens to send
Yes
msg
binary
Base64 encoded message to pass to the receiving contract
Yes
***
## Usage as Collateral
nTokens can be used as collateral in Neptune markets, allowing users to maintain their lending positions while borrowing against them. When used as collateral, nTokens are valued based on:
1. The current market price of the underlying asset
2. The current redemption rate of the nToken
3. The collateral parameters set for the specific nToken
This enables strategies like:
* Leveraging lending positions
* Maintaining exposure to lending yields while accessing liquidity
* Complex yield strategies combining lending and borrowing