🎨ord_sendInscriptions

You can use the ord_sendInscriptions method to request inscription transfers from your user's connected wallet's ordinal address. You can request multiple transfers in a single request, each transfer involving:

  • an inscription

  • a recipient address

The method accepts a transfers array as request parameter:

Request parametersDescription

transfers

an array of transfer objects with <inscriptionId, recipient> properties:

import { Wallet } from "sats-connect";

   const response = await Wallet.request('ord_sendInscriptions', {transfers: 
    [
      {
        inscriptionId: '22e63b19dede2882b2478f7182aa4ea8cd4a8289acd7a7d5dde96fcaaf4cd089i0',
        address: ordinalsAddress1,
      },
      {
        inscriptionId: '9a83420dbe566531114066a03d8022425064a78992710fab7006948eaa1d3546i0',
        address: ordinalsAddress2,
      }]  
    });

    if (response.status === "success") {
      // handle success
    } else {
      if (response.error.code === RpcErrorCode.USER_REJECTION) {
        // handle user cancellation error
      } else {
        // handle error
      }
    }
  } catch (err) {
      alert(err.error.message);
  }

The user will be prompted to review the inscription transfer transaction in the wallet, and to confirm:

  • the inscriptions to send and their recipients

  • their desired Bitcoin transaction fee

The transaction will be signed and broadcasted upon user approval.

The ord_sendInscriptions method returns a Promise that resolves to the sendInscriptionsResultSchema object:

PropertyDescription

txid

The Bitcoin transaction id as a hex-encoded string.

Last updated