> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peaq.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Transfer Operations

The peaq network provides methods to transfer tokens across supported chains (peaq and agung). This includes native token transfers, ERC-20 token transfers, and ERC-721 (NFT) transfers.

## native(to, amount)

Transfers the native token from the signer to a target address.

| Parameter  | Type                             | EVM      | Substrate | Description                                      |
| ---------- | -------------------------------- | -------- | --------- | ------------------------------------------------ |
| **to**     | `str`                            | Required | Required  | The recipient address (either SS58 or EVM H160). |
| **amount** | `int \| float \| str \| Decimal` | Required | Required  | Human-readable token amount (e.g., 1.5).         |

### Native Token Transfer Code Examples

<CodeGroup>
  ```python EVM to EVM theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
  import os
  from dotenv import load_dotenv
  from peaq_sdk import Sdk
  from peaq_sdk.types import ChainType

  load_dotenv()

  HTTPS_PEAQ_URL = os.getenv("HTTPS_PEAQ_URL")
  EVM_PRIVATE_KEY = os.getenv("EVM_PRIVATE_KEY")
  EVM_ADDRESS = os.getenv("EVM_ADDRESS")

  sdk = Sdk.create_instance(
      base_url=HTTPS_PEAQ_URL,
      chain_type=ChainType.EVM,
      seed=EVM_PRIVATE_KEY
  )

  amount = 1.5

  response = sdk.transfer.native(to=EVM_ADDRESS, amount=amount)
  ```

  ```python EVM to EVM receipt theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
  {
    "message": "Sent 1.5 native-token from 0x9Eeab1aCcb1A701aEfAB00F3b8a275a39646641C to 0x3e3FF16083Bf0a444B8fF86C7156eB3368e3cefB.",
    "receipt": {
      "transactionHash": "0xeb349f98c31e414b76a674ed7b435005e9e717bc6459156d736c66999bec5728",
      "transactionIndex": 0,
      "blockHash": "0xa28e6d76a5b2aea0c24c9f4e39c548c1ddcaeebcffdf6273a4e07b3db36730c0",
      "from": "0x9Eeab1aCcb1A701aEfAB00F3b8a275a39646641C",
      "to": "0x3e3FF16083Bf0a444B8fF86C7156eB3368e3cefB",
      "blockNumber": 5848490,
      "cumulativeGasUsed": 21000,
      "gasUsed": 21000,
      "contractAddress": null,
      "logs": [],
      "logsBloom": "0x000000000000000000000000000000000000000000000...",
      "status": 1,
      "effectiveGasPrice": 102000000000,
      "type": 2
    }
  }
  ```

  ```python EVM to Substrate theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
  import os
  from dotenv import load_dotenv
  from peaq_sdk import Sdk
  from peaq_sdk.types import ChainType

  load_dotenv()

  HTTPS_PEAQ_URL = os.getenv("HTTPS_PEAQ_URL")
  EVM_PRIVATE_KEY = os.getenv("EVM_PRIVATE_KEY")
  SUBSTRATE_ADDRESS = os.getenv("SUBSTRATE_ADDRESS")

  sdk = Sdk.create_instance(
      base_url=HTTPS_PEAQ_URL,
      chain_type=ChainType.EVM,
      seed=EVM_PRIVATE_KEY
  )

  amount = 1.5

  response = sdk.transfer.native(to=SUBSTRATE_ADDRESS, amount=amount)
  ```

  ```python EVM to Substrate receipt theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
  {
    "message": "Sent 1.5 native-token from 0x9Eeab1aCcb1A701aEfAB00F3b8a275a39646641C to 5FEw7aWmqcnWDaMcwjKyGtJMjQfqYGxXmDWKVfcpnEPmUM7q.",
    "receipt": {
      "transactionHash": "0x006077a3dbc93d2ebaa3ed20e4764ba41de122edd2eaa338f4e593750dcd6d6f",
      "transactionIndex": 0,
      "blockHash": "0xb64e5c258440264ff9f354700a56e96102fddedfcabd937f20081ad40843965e",
      "from": "0x9Eeab1aCcb1A701aEfAB00F3b8a275a39646641C",
      "to": "0x0000000000000000000000000000000000000809",
      "blockNumber": 5848515,
      "cumulativeGasUsed": 30423,
      "gasUsed": 30423,
      "contractAddress": null,
      "logs": [
        {
          "address": "0x0000000000000000000000000000000000000809",
          "topics": [
            "0xa1f949b36d49ecc12f7df90e9e1c2dfc2091941dbc70b29ad1b995253a47853b",
            "0x0000000000000000000000009eeab1accb1a701aefab00f3b8a275a39646641c",
            "0x8c81c81b633fae0cc5713dd9d7ac2ae9fe5d63112b396554c0d8e19b199daf1d"
          ],
          "data": "0x00000000000000000000000000000000000000000000000014d1120d7b160000",
          "blockHash": "0xb64e5c258440264ff9f354700a56e96102fddedfcabd937f20081ad40843965e",
          "blockNumber": 5848515,
          "transactionHash": "0x006077a3dbc93d2ebaa3ed20e4764ba41de122edd2eaa338f4e593750dcd6d6f",
          "transactionIndex": 0,
          "logIndex": 0,
          "transactionLogIndex": "0x0",
          "removed": false
        }
      ],
      "logsBloom": "0x000000000000000000000000080000000080000...",
      "status": 1,
      "effectiveGasPrice": 102000000000,
      "type": 2
    }
  }
  ```

  ```python Substrate to EVM theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
  import os
  from dotenv import load_dotenv
  from peaq_sdk import Sdk
  from peaq_sdk.types import ChainType

  load_dotenv()

  WSS_PEAQ_URL = os.getenv("WSS_PEAQ_URL")
  SUBSTRATE_SEED = os.getenv("SUBSTRATE_SEED")
  EVM_ADDRESS = os.getenv("EVM_ADDRESS")


  sdk = Sdk.create_instance(
      base_url=WSS_PEAQ_URL,
      chain_type=ChainType.SUBSTRATE,
      seed=SUBSTRATE_SEED
  )

  amount = 1.5

  response = sdk.transfer.native(to=EVM_ADDRESS, amount=amount)
  ```

  ```python Substrate to EVM receipt theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
  {
    "message": "Sent 1.5 native-token from 5Df42mkztLtkksgQuLy4YV6hmhzdjYvDknoxHv1QBkaY12Pg to 0x3e3FF16083Bf0a444B8fF86C7156eB3368e3cefB.",
    "receipt": {
      "extrinsic_hash": "0x18097b6e184090630d0a136c477a37b80460b8cf9e79074289e2e00b20549e07",
      "block_hash": "0x8616cb83c69ff2795b4cea5eab7cd3ed5dcd3c634f6dbdc3f373ecff9a96e8fc",
      "from": "5Df42mkztLtkksgQuLy4YV6hmhzdjYvDknoxHv1QBkaY12Pg",
      "to": "5Gt6N8WZRfWDuULHrQyVd1qbcHiuVjMTq5MyKhDss7s2mCUF",
      "amount": 1500000000000000000,
      "fee": 1972642001704138,
      "events": [
        ...
        {
          "event": "Transfer",
          "from": "5Df42mkztLtkksgQuLy4YV6hmhzdjYvDknoxHv1QBkaY12Pg",
          "to": "5Gt6N8WZRfWDuULHrQyVd1qbcHiuVjMTq5MyKhDss7s2mCUF",
          "amount": 1500000000000000000
        },
        ...
      ],
      "success": true
    }
  }
  ```

  ```python Substrate to Substrate theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
  import os
  from dotenv import load_dotenv
  from peaq_sdk import Sdk
  from peaq_sdk.types import ChainType

  load_dotenv()

  WSS_PEAQ_URL = os.getenv("WSS_PEAQ_URL")
  SUBSTRATE_SEED = os.getenv("SUBSTRATE_SEED")
  SUBSTRATE_ADDRESS = os.getenv("SUBSTRATE_ADDRESS")


  sdk = Sdk.create_instance(
      base_url=WSS_PEAQ_URL,
      chain_type=ChainType.SUBSTRATE,
      seed=SUBSTRATE_SEED
  )
  amount = 1.5

  response = sdk.transfer.native(to=SUBSTRATE_ADDRESS, amount=amount)
  ```

  ```python Substrate to Substrate receipt theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
  {
    "message": "Sent 1.5 native-token from 5Df42mkztLtkksgQuLy4YV6hmhzdjYvDknoxHv1QBkaY12Pg to 5FEw7aWmqcnWDaMcwjKyGtJMjQfqYGxXmDWKVfcpnEPmUM7q.",
    "receipt": {
      "extrinsic_hash": "0xbe07335455ba0dfb33812499a42e8b9c16df65932281ed162696559c5de73494",
      "block_hash": "0x4a015f85f4a858f89977c981b0b165af0cfa110534a6f89a041843ab6946733d",
      "from": "5Df42mkztLtkksgQuLy4YV6hmhzdjYvDknoxHv1QBkaY12Pg",
      "to": "5FEw7aWmqcnWDaMcwjKyGtJMjQfqYGxXmDWKVfcpnEPmUM7q",
      "amount": 1500000000000000000,
      "fee": 1972642001704138,
      "events": [
        ...
        {
          "event": "Transfer",
          "from": "5Df42mkztLtkksgQuLy4YV6hmhzdjYvDknoxHv1QBkaY12Pg",
          "to": "5FEw7aWmqcnWDaMcwjKyGtJMjQfqYGxXmDWKVfcpnEPmUM7q",
          "amount": 1500000000000000000
        },
        ...
      ],
      "success": true
    }
  }
  ```
</CodeGroup>

## erc20(erc\_20\_address, recipient\_address, amount, token\_decimals)

Transfers ERC-20 tokens from the signer to a recipient address.

| Parameter              | Type                             | EVM      | Substrate | Description                                        |
| ---------------------- | -------------------------------- | -------- | --------- | -------------------------------------------------- |
| **erc\_20\_address**   | `str`                            | Required | N/A       | The address of the ERC-20 contract.                |
| **recipient\_address** | `str`                            | Required | N/A       | The recipient's address.                           |
| **amount**             | `int \| float \| str \| Decimal` | Required | N/A       | Human-readable token amount.                       |
| **token\_decimals**    | `int \| float \| str \| Decimal` | Optional | N/A       | Number of decimals for the token (defaults to 18). |

### ERC-20 Transfer Code Examples

<CodeGroup>
  ```python EVM Write Tx theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
  import os
  from dotenv import load_dotenv
  from peaq_sdk import Sdk
  from peaq_sdk.types import ChainType

  load_dotenv()

  HTTPS_PEAQ_URL = os.getenv("HTTPS_PEAQ_URL")
  EVM_PRIVATE_KEY = os.getenv("EVM_PRIVATE_KEY")

  sdk = Sdk.create_instance(
      base_url=HTTPS_PEAQ_URL,
      chain_type=ChainType.EVM,
      seed=EVM_PRIVATE_KEY
  )

  ERC_20_ADDRESS = os.getenv("ERC_20_ADDRESS")
  EVM_ADDRESS = os.getenv("EVM_ADDRESS")
  amount = 1.5
  token_decimals = 18

  response = sdk.transfer.erc20(
      erc_20_address=ERC_20_ADDRESS,
      recipient_address=EVM_ADDRESS,
      amount=amount,
      token_decimals=token_decimals
  )
  ```

  ```python EVM Write Tx Receipt theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
  {
    "message": "Transferred 1.5 of the erc-20 at address 0xFF78784737e8e124cb38603eD3DA78f071f50c2a to the new owner of 0x3e3FF16083Bf0a444B8fF86C7156eB3368e3cefB from the owner 0x9Eeab1aCcb1A701aEfAB00F3b8a275a39646641C.",
    "receipt": {
      "transactionHash": "0xc1b8bd9a02a59bcd21aa71200c0e4c7c38117636262cdeae462bd029e24538fc",
      "transactionIndex": 0,
      "blockHash": "0xef507bcb8f5fb76fb28d24573597d86618d0d5e4965f3d352bd48fd21c2178ce",
      "from": "0x9Eeab1aCcb1A701aEfAB00F3b8a275a39646641C",
      "to": "0xFF78784737e8e124cb38603eD3DA78f071f50c2a",
      "blockNumber": 5848651,
      "cumulativeGasUsed": 34492,
      "gasUsed": 34492,
      "status": 1,
      "effectiveGasPrice": 102000000000,
      "type": 2,
      "logs": [
        {
          "address": "0xFF78784737e8e124cb38603eD3DA78f071f50c2a",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x0000000000000000000000009eeab1accb1a701aefab00f3b8a275a39646641c",
            "0x0000000000000000000000003e3ff16083bf0a444b8ff86c7156eb3368e3cefb"
          ],
          "data": "0x00000000000000000000000000000000000000000000000014d1120d7b160000",
          "blockHash": "0xef507bcb8f5fb76fb28d24573597d86618d0d5e4965f3d352bd48fd21c2178ce",
          "blockNumber": 5848651,
          "transactionHash": "0xc1b8bd9a02a59bcd21aa71200c0e4c7c38117636262cdeae462bd029e24538fc",
          "transactionIndex": 0,
          "logIndex": 0,
          "transactionLogIndex": "0x0",
          "removed": false
        }
      ]
    }
  }
  ```
</CodeGroup>

## erc721(erc\_721\_address, recipient\_address, token\_id)

Transfers an ERC-721 token (NFT) from the signer to a recipient address using the `safeTransferFrom` method.

| Parameter              | Type  | EVM      | Substrate | Description                          |
| ---------------------- | ----- | -------- | --------- | ------------------------------------ |
| **erc\_721\_address**  | `str` | Required | N/A       | The address of the ERC-721 contract. |
| **recipient\_address** | `str` | Required | N/A       | The recipient's address.             |
| **token\_id**          | `int` | Required | N/A       | The ID of the token to transfer.     |

### ERC-721 Transfer Code Examples

<CodeGroup>
  ```python EVM Write Tx theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
  import os
  from dotenv import load_dotenv
  from peaq_sdk import Sdk
  from peaq_sdk.types import ChainType

  load_dotenv()

  HTTPS_PEAQ_URL = os.getenv("HTTPS_PEAQ_URL")
  EVM_PRIVATE_KEY = os.getenv("EVM_PRIVATE_KEY")

  sdk = Sdk.create_instance(
      base_url=HTTPS_PEAQ_URL,
      chain_type=ChainType.EVM,
      seed=EVM_PRIVATE_KEY
  )

  ERC_721_ADDRESS = os.getenv("ERC_721_ADDRESS")
  EVM_ADDRESS = os.getenv("EVM_ADDRESS")
  TOKEN_ID = 1

  response = sdk.transfer.erc721(
      erc_721_address=ERC_721_ADDRESS,
      recipient_address=EVM_ADDRESS,
      token_id=TOKEN_ID
  )
  ```

  ```python EVM Write Tx Receipt theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
  {
    "message": "Transferred NFT at address 0x3319176b32a4c1e68c02ef454c148ee9b5363c33 to the new owner of 0x3e3FF16083Bf0a444B8fF86C7156eB3368e3cefB from the owner 0x9Eeab1aCcb1A701aEfAB00F3b8a275a39646641C.",
    "receipt": {
      "transactionHash": "0xd483ec3f28326c27d824b2d42fc434ee16c2f25a900d87c4a6a3dd383e87547d",
      "transactionIndex": 0,
      "blockHash": "0xb71f47ee73a11a8653397bb7e3ea9e40d8bbdc5a2382db72aae854027f5e62c3",
      "from": "0x9Eeab1aCcb1A701aEfAB00F3b8a275a39646641C",
      "to": "0x3319176b32A4c1e68C02Ef454C148eE9b5363C33",
      "blockNumber": 5848729,
      "cumulativeGasUsed": 89772,
      "gasUsed": 89772,
      "contractAddress": null,
      "logs": [
        {
          "address": "0x3319176b32A4c1e68C02Ef454C148eE9b5363C33",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x0000000000000000000000009eeab1accb1a701aefab00f3b8a275a39646641c",
            "0x0000000000000000000000003e3ff16083bf0a444b8ff86c7156eb3368e3cefb",
            "0x000000000000000000000000000000000000000000000000000000000000c29d"
          ],
          "data": "0x",
          "blockHash": "0xb71f47ee73a11a8653397bb7e3ea9e40d8bbdc5a2382db72aae854027f5e62c3",
          "blockNumber": 5848729,
          "transactionHash": "0xd483ec3f28326c27d824b2d42fc434ee16c2f25a900d87c4a6a3dd383e87547d",
          "transactionIndex": 0,
          "logIndex": 0,
          "transactionLogIndex": "0x0",
          "removed": false
        }
      ],
      "logsBloom": "0x0000000000000000000000000000000000800000...",
      "status": 1,
      "effectiveGasPrice": 102000000000,
      "type": 2
    }
  }
  ```
</CodeGroup>