Link Accessories

Asset link creation operation

An asset link creation operation within an ARTM typically consists of the following structure:

{
  type: 'asset-link',
  action: 'create',
  args: [
    // Operator
    'equipWith_asmBrain',
    // Opearand A: Boxer Asset ID
    'did:fv-asset:1:evm:0x6bca6de2dbdc4e0d41f7273011785ea16ba47182:1000',
    // Opearand B: Brain Asset ID
    'did:fv-asset:1:evm:0x1ea66a857de297471bc12dd12d93853ff6617284:21',
  ],
}

Ownership check for link creation

The user must own both assets to create links unless it is an off-chain asset, where only the creator of the child asset can create a link. Linking between assets owned on a FuturePass account and FuturePass account owner EOA is allowed. As long as the ownership resolution is satisfied, links can also be created across chains.

React

import {
  useGetARTM,
  useSignAndSubmitTransaction,
  useGetTransaction,
} from '@futureverse/asset-register-react/v2'

const linkOperation = {
  type: 'asset-link',
  action: 'create',
  args: [
    'equipWith_asmBrain',
    // Boxer
    'did:fv-asset:1:evm:0x6bca6de2dbdc4e0d41f7273011785ea16ba47182:1000',
    // Brain
    'did:fv-asset:1:evm:0x1ea66a857de297471bc12dd12d93853ff6617284:21',
  ],
}

const LinkAccessory = ({ address }) => {
  const {
    artm,
    reactQuery: { refetch: getARTM },
  } = useGetARTM(
    {
      address,
      [],
    },
    { enabled: false },
  )

  const { submitAsync, transaction } = useSignAndSubmitTransaction()
  // Polling tx status after submitted
  const { transaction: transactionStatus } = useGetTransaction(
    { transactionHash: transaction?.transactionHash as any },
    {
      refetchInterval: (data) => (data?.status === 'PENDING' ? 2000 : false),
      enabled: !!transaction?.transactionHash,
    },
  )

  const submitARTM = async () => {
    const { data: artm } = await getARTM()
    if (!artm) {
      return
    }
    artm.addOperation(linkOperation)
    return submitAsync({ artm })
  }

  return (
    <>
      <button onClick={submitARTM}>Submit link accessory TX</button>
      {transactionStatus && <div>{`tx status: ${transactionStatus.status}`}</div>}
    </>
  )
}

Node.js

import { AssetRegister } from '@futureverse/asset-register'
import {
  AssetTransactionMessage,
  Signature,
  chainAddressFromString,
} from '@futureverse/asset-register/types'
import { ARTM, STATEMENTS } from '@futureverse/artm'

const address = "YOUR_WALLET_ADDRESS"
const linkOperation = {
  type: 'asset-link',
  action: 'create',
  args: [
    'equipWith_asmBrain',
    'did:fv-asset:1:evm:0x6bca6de2dbdc4e0d41f7273011785ea16ba47182:1000',
    'did:fv-asset:1:evm:0x1ea66a857de297471bc12dd12d93853ff6617284:21',
  ],
}

const ar = new AssetRegister({
    ...
})

const getARTM = async () => {
  const nonce = await ar.nonceForChainAddress(chainAddressFromString(address))
  return new ARTM({
    operations: [linkOperation],
    nonce,
    address,
    statement: STATEMENTS.ASSET_UPDATE,
  })
}

const signAndSubmit = async () => {
  const artm = await getARTM()
  await ar.sign(artm)
  const assetInput = {
    transaction: artm.message as AssetTransactionMessage,
    signature: artm.signature as Signature,
  }
  return ar.submitTransaction(assetInput)
}

signAndSubmit()

GraphQL

1. Get nonce.

   query GetNonceForChainAddress($input: NonceInput!) {
     getNonceForChainAddress(input: $input)
   }

   {
     "input": {
       "chainAddress": "0x2d2438c6281b5115733287fc279f854c868d3ee2"
     }
   }

2. Get message and signature through ARTM.

   import { ARTM, STATEMENTS } from '@futureverse/artm'
   const linkOperation = {
     type: 'asset-link',
     action: 'create',
     args: [
       'equipWith_asmBrain',
       'did:fv-asset:1:evm:0x6bca6de2dbdc4e0d41f7273011785ea16ba47182:1000',
       'did:fv-asset:1:evm:0x1ea66a857de297471bc12dd12d93853ff6617284:21',
     ],
   }
   const artm = new ARTM({
       operations: [linkOperation],
       nonce,
       address,
       statement: STATEMENTS.ASSET_UPDATE,
   })

3. Submit transaction

   mutation SubmitTransaction($input: SubmitTransactionInput!) {
     submitTransaction(input: $input) {
       transactionHash
     }
   }

   {
     "input": {
       "transaction": artm.message,
       "signature": artm.signature
     }
   }

4. Check transaction status

   query GetTransaction($transactionHash: TransactionHash!) {
     transaction(transactionHash: $transactionHash) {
       id
       status
       transactionHash
       error {
         message
         code
       }
     }
   }

   {
     "transactionHash": "0x0f35cc253abccfb69ecfba5a3fc6696a518aa5ad8bc1e19c71c73446269057c8"
   }