@verto/js

Verto JS Library

Integrate The Verto Exchange's protocol easily

• Installation
• Initialization
• Testnet usage
• Usage
  • Exchange
    • Adding a new pair
    • Swapping between two tokens
    • Cancelling an order
    • Get the orderbook
    • Get an order
    • Get an estimate for a swap
  • Token
    • Get tokens
    • Get a token's type
    • Get a flexible logo for the token
    • Transfer tokens
    • List a token
  • User
    • Get user data
    • Get balance
    • Get orders
    • Get transactions
• License

Installation

npm install @verto/js

or

yarn add @verto/js

Initialization

To use the library, you'll need to initialize it:

import Verto from "@verto/js";

const client = new Verto();

You can initialise with a few optional parameters to customize the behaviour of the library:

const client = new Verto(
  { ... }, // wallet to use for interactions (for arconnect, leave it undefined or "use_wallet")
  new Arweave(...), // custom arweave client
  false, // optionally disable loading contract data from the cache. Note: this will slow down fetching
  {
    CLOB_CONTRACT: "...", // optional custom clob contract
    COMMUNITY_CONTRACT: "..." // optional custom community contract
  }
);

Testnet usage

For the Verto testnet, you can use the following configuration:

const client = new Verto(
  "use_wallet", // can be configured
  new Arweave({
    host: "www.arweave.run",
    port: "443",
    protocol: "https",
  }),
  true, // can be configured
  {
    COMMUNITY_CONTRACT: "ppk1GzzOU2hwjEUMqVkqyAvsj-BPakNzuEKEzhJtyJE",
    CLOB_CONTRACT: "ySwuiyQGm-jDDa2OD1ub6QLWTCklOxkPesnaJnmoFUc",
    CACHE_CONFIG: {
      CONTRACT_CDN:
        "https://storage.googleapis.com/verto-exchange-contracts-stage",
      CACHE_API: "https://verto-qa.wn.r.appspot.com",
    },
    EXCHANGE_CONTRACT: "krW6M5Y1zqcWorlWjSURE-C7s0UsLO5whuOBLDecNlg",
  }
);

Usage

The library supports data requests and interactions with the protocol:

Exchange

The exchange submodule is accessible like this:

// example usage to access the swap function in the exchange submodule
await client.exchange.swap(...);

Adding a new pair

This will add a new pair to the exchange protocol.

const interactionID = await client.exchange.addPair([
  "usjm4PCxUd5mtaon7zc97-dt-3qf67yPyqgzLnLqk5A", // token ids for the pair
  "-8A6RexFkpfWwuyVO98wzSFZh0d6VJuI-buTJvlwOJQ",
]);

The function takes two params:

• pair: A tuple of two token IDs to add as a pair
• tags: Optional. Custom tags to add to the interaction

The function returns the created interaction's ID.

Swapping between two tokens

This will create a new swap between two Arweave tokens.

const interactionID = await client.exchange.swap(
  [
    "usjm4PCxUd5mtaon7zc97-dt-3qf67yPyqgzLnLqk5A",
    "-8A6RexFkpfWwuyVO98wzSFZh0d6VJuI-buTJvlwOJQ",
  ],
  1000
);

The function takes four params:

• pair: The two tokens to trade between. Must be an existing pair
• amount: The amount of tokens sent to the contract
• price: Optional. Price for the order
• tags: Optional. Custom tags to add to the interaction

The function returns the created interaction's ID.

Cancelling an order

This will return the non-filled tokens for an order and remove it from the orderbook.

const interactionID = await client.exchange.cancel(
  "xUd5mtaonpfWwuyVO98wzSFZh0d6VJuIxbuTJvlwOJQ"
);

The function takes one param:

• orderID: The transaction id of the swap

The function returns the created interaction's ID.

Get the orderbook

This fetches the order book for a specific token from the CLOB contract.

// for a specific token
const tokenOrders = await client.exchange.getOrderBook(
  "usjm4PCxUd5mtaon7zc97-dt-3qf67yPyqgzLnLqk5A"
);

// for a token pair
const pairOrders = await client.exchange.getOrderBook([
  "usjm4PCxUd5mtaon7zc97-dt-3qf67yPyqgzLnLqk5A",
  "-8A6RexFkpfWwuyVO98wzSFZh0d6VJuI-buTJvlwOJQ",
]);

// for all orders in the contract
const allOrders = await client.exchange.getOrderBook();

The function takes one param:

• input: Token contract ID or token pair tuple

The function returns an array of orders.

Get an order

Fetches a single order from the orderbook by it's ID.

const order = await client.exchange.getOrder(
  "xUd5mtaonpfWwuyVO98wzSFZh0d6VJuIxbuTJvlwOJQ"
);

The function takes one param:

• orderID: The transaction ID of the order interaction

The function returns an order along with the token pair it belongs to.

Get an estimate for a swap

Calculates an estimate of the amount of tokens that the user would receive by making a swap.

const estimate = await client.exchange.estimateSwap(
  [
    "usjm4PCxUd5mtaon7zc97-dt-3qf67yPyqgzLnLqk5A",
    "-8A6RexFkpfWwuyVO98wzSFZh0d6VJuI-buTJvlwOJQ",
  ],
  10,
  3
);

The function takes three params:

• pair: The two tokens to trade between. Must be an existing pair
• amount: The amount of tokens sent to the contract
• price: Optional. Price for the order

The function returns an object with all the costs for the swap, and how much the user would get refunded / received.

Token

Get tokens

Fetches all tokens, such as NFTs, PSTs and communities listed on Verto.

const tokens = await client.token.getTokens();

The function takes one param:

• type: Optional. Type filter

The function returns an array of tokens.

Get a token's type

Fetches the type of a given token.

const type = await client.token.getTokenType(
  "usjm4PCxUd5mtaon7zc97-dt-3qf67yPyqgzLnLqk5A"
);

The function takes one param:

• id: Token contract id

The function returns the type of the token.

Get a flexible logo for the token

Returns a flexible logo's URL, that supports dark & light theme. If the token doesn't have a logo, it will return a placeholder for it.

The function uses the CryptoMeta API by Ashlar. Logos can be submitted here;

const logo = client.token.getLogo(
  "usjm4PCxUd5mtaon7zc97-dt-3qf67yPyqgzLnLqk5A",
  "dark"
);

The function takes two params:

• id: Token contract ID
• theme: Optional. UI theme to return the icon for ("light" | "dark")

The function returns an URL for the appropriate logo.

Transfer tokens

Send tokens to a target address.

const interactionID = await client.token.transfer(
  1000,
  "usjm4PCxUd5mtaon7zc97-dt-3qf67yPyqgzLnLqk5A",
  "XcNXJS1UcJ05rTMWPo7l8liFFTBRgL3McfFGVliIybs"
);

The function takes four params:

• amount: The amount of tokens to send
• id: Token contract ID
• target: Target of the transfer
• tags: Optional. Custom tags for the interaction

The function returns the created interaction's ID.

List a token

List a new token on the exchange protocol.

const interactionID = await client.token.list(
  "usjm4PCxUd5mtaon7zc97-dt-3qf67yPyqgzLnLqk5A",
  "community"
);

The function takes three params:

• id: Token contract ID
• type: The type of the token
• tags: Optional. Custom tags for the interaction

The function returns the created interaction's ID.

User

Get user data

Fetch user info for an input (address or username).

const userinfo = await client.user.getUser("martonlederer");

The function takes one param:

• input: User wallet address or username

The function returns the user's data (avatar, name, etc.).

Get balance

Fetch assets for a given address.

const balances = await client.user.getBalances(
  "usjm4PCxUd5mtaon7zc97-dt-3qf67yPyqgzLnLqk5A",
  "art"
);

The function takes one param:

• input: User name or user wallet address
• type: Optional. Token type filter

The function returns the balances for the user.

Get orders

Fetch orders for a given address.

const orders = await client.user.getOrders(
  "usjm4PCxUd5mtaon7zc97-dt-3qf67yPyqgzLnLqk5A"
);

The function takes one param:

• input: User wallet address

The function returns the orders for the user.

Get transactions

Fetch transactions for a given wallet address.

const transactions = await client.user.getTransactions(
  "usjm4PCxUd5mtaon7zc97-dt-3qf67yPyqgzLnLqk5A"
);

The function takes one params:

• input: User wallet address
• after: Optional. Transaction to fetch after

The function returns the transactions for the user.

License

The code contained within this repository is licensed under the MIT license. See ./LICENSE for more information.