# CW721 Tokens

Paloma.py enables developers to create and interact with the Cosmos version of NFTs - CW721 tokens (opens new window) without knowing Rust. The SDK allows you to bypass learning CosmWasm and simply staying in Python.

There are 9 functions for CW721 that are implemented in paloma.py.

# instantiate()

Create a new CW721 by instantiating a CW721 smart contract. You'll need the the code id of a deployed CW20 compatible wasm code You can find the deployed CW721 compatible contracts in the resource section. You may also upload your own contract and use that instead. See the smart contract documentation for more details. As CW721 creator, you'll choose the name, symbol and the total supply amount which is minted to deployer wallet.

Arguments:

wallet (Paloma address): CW721 deployer wallet address
code_id (int): Code_id of CW721 wasm code
name (str): CW721 token name
symbol (str): CW721 token symbol
minter CW721 token minter
decimals (int): CW721 token decimals
total_supply (int): CW721 token total supply

Returns: BlockTxBroadcastResult: Transaction Broadcast Result

# mint()

With this function you will be able to mint the NFTs

Arguments:

wallet (Paloma address): CW721 sender wallet address
token (str): CW721 token address
token_id (str): CW721 token id
owner (str): owner who will receive the CW721 token
token_uri (str): URI of the minting token used to construct the metadata

Returns: BlockTxBroadcastResult: Transaction Broadcast Result

# approve()

This allows the spender to transfer or send the token from the owner's account. If expires is set, then this allowance expires at the time/height limit.

Arguments:

wallet (Paloma address): CW721 owner wallet address
token (str): CW721 token address
spender (str): the address who will get permission to the CW721 token
token_id (str): token id of the CW721 token
expires: (dict, optional) {"at_height": height(u64)} / {"at_time":timestamp(nanosecond, u64)}

Returns: BlockTxBroadcastResult: Transaction Broadcast Result

# revoke()

Removes previously granted approval from the spender.

Arguments:

wallet (Paloma address): CW721 sender wallet addresss
token (str): token address
spender (str): approved address for which approval should be revoked
token_id (str): CW721 token id

Returns BlockTxBroadcastResult: Transaction Broadcast Result

# approve_all()

This function allows an operator to transfer or send any available token from the owner's account. If expires is set, then this allowance has a time/height limit

Arguments:

wallet (Paloma address): CW721 sender wallet address
token (str): CW721 token address
operator (str): the address who will get permission to the CW721 tokens
expires: (dict, optional) {"at_height": height(u64)} / {"at_time":timestamp(nanosecond, u64)}

Returns: BlockTxBroadcastResult: Transaction Broadcast Result

# revoke_all()

Removes previously granted approval from the operator.

Arguments:

wallet (Paloma address): CW721 sender wallet address
token (str): CW721 token address
operator (str): approved address for which approval should be revoked

Returns: BlockTxBroadcastResult: Transaction Broadcast Result

# transfer_nft()

Allows to send a CW721 NFT token to another address

Arguments:

wallet (Paloma address): CW721 sender wallet address
token (str): CW721 token address
recipient (str): token receiver address
token_id (str): token id

Returns: BlockTxBroadcastResult: Transaction Broadcast Result

# send_nft()

This function allows you to send a CW721 token to a CW721 compatible contract along with a message.

Arguments:

wallet (Paloma address): CW721 sender wallet address
token (str): CW721 token address
contract (str): token receiver contract address
token_id (str): token id
msg (str): base64 encoded message

Returns: BlockTxBroadcastResult: Transaction Broadcast Result

# burn()

This removes a specific CW721 token.

Arguments:

wallet (Paloma Address): wallet from which the tokens should be removed
token (str): CW721 token address
token_id (str): token id to be burnt

Returns: BlockTxBroadcastResult: Transaction Broadcast Result

# Example

See the example below for a sample use of the available functions.

import asyncio
from pathlib import Path

import uvloop
from terra_proto.cosmwasm.wasm.v1 import AccessType
from paloma_sdk.client.lcd import AsyncLCDClient
from paloma_sdk.client.lcd.api.tx import CreateTxOptions
from paloma_sdk.core.wasm import MsgInstantiateContract, MsgStoreCode
from paloma_sdk.key.mnemonic import MnemonicKey
from paloma_sdk.core.wasm.data import AccessConfig
from paloma_sdk.util.contract import get_code_id, get_contract_address, read_file_as_b64


async def main():
    paloma = AsyncLCDClient(url="https://lcd.testnet.palomaswap.com/", chain_id="paloma-testnet-15")
    paloma.gas_prices = "0.01ugrain"
    # test1 = paloma.wallets["test1"]
    acc = MnemonicKey(
        mnemonic="notice oak worry limit wrap speak medal online prefer cluster roof addict wrist behave treat actual wasp year salad speed social layer crew genius"
    )

    acc2 = MnemonicKey(
        mnemonic="index light average senior silent limit usual local involve delay update rack cause inmate wall render magnet common feature laundry exact casual resource hundred"
    )
    test1 = paloma.wallet(acc)
    test2 = paloma.wallet(acc2)

    # print(test1.key.acc_address)
    store_code_tx = await test1.create_and_sign_tx(
        CreateTxOptions(
            msgs=[
                MsgStoreCode(
                    test1.key.acc_address,
                    read_file_as_b64(Path(__file__).parent / "./cw721_base.wasm"),
                    AccessConfig(AccessType.ACCESS_TYPE_EVERYBODY, ""),
                )
            ]
        )
    )
    store_code_tx_result = await paloma.tx.broadcast(store_code_tx)
    print(store_code_tx_result)

    code_id = get_code_id(store_code_tx_result)

    # code_id = 1
    print(f"code_id:{code_id}")

    result = await paloma.cw721.instantiate(
        test1, code_id, "CW721 Token", "CWFT", test1.key.acc_address
    )
    print(result)
    
    contract_address = result.logs[0].events_by_type["instantiate"][
            "_contract_address"
        ][0]
    print(contract_address)

    result = await paloma.cw721.mint(
        test1, contract_address, "1", test1.key.acc_address, "test uri"
    )
    print(result)

    result = await paloma.cw721.approve(
        test1, contract_address, test2.key.acc_address, "1"
    )
    print(result)

    result = await paloma.cw721.revoke(
        test1, contract_address, test2.key.acc_address, "1"
    )
    print(result)

    result = await paloma.cw721.approve_all(
        test1, contract_address, test2.key.acc_address
    )
    print(result)

    result = await paloma.cw721.revoke_all(
        test1, contract_address, test2.key.acc_address
    )
    print(result)

    result = await paloma.cw721.transfer_nft(
        test1, contract_address, test2.key.acc_address, "1"
    )
    print(result)

    result = await paloma.cw721.burn(
        test2, contract_address, "1"
    )
    print(result)

    await paloma.session.close()


uvloop.install()
asyncio.run(main())

← CW20 Tokens Resources and tools →