Update offer: (meta)TxApprove

Endpoint to pass the transaction hash of the Approve transaction

In order for the market to take an NFT into custody, the market requires the end user to execute a contract call, allowing the market to move the NFT. Since the market doesn't know the end-users of the client, it is up to the client to ask the user to perform the Approve transaction. Once the user has launched the Approve transaction the client sends the transaction hash of that transaction back to the market for validation.

Since there are multiple variants and standards of NFT contracts it can be difficult for a client to know for each NFT contract which function to call and which input parameter each function might need. To overcome that specific pain the market also provides an endpoint that returns that required information, allowing the client to easily query what they need to forward to their end-users.

Based on contract specifics, one of two approvals need to be done: Meta transaction approvals, or (traditional) transaction approvals. To know which approval needs to be done, look for the response in GET prepared approve tx.

pageGet prepared Approve tx

PATCH//offers/{id}/txapprove

Path parameters

id*string

Body

application/json

txApprove*string

Response

200400401403404405415500

OK

Body

*/*

successboolean

resultone of

AuctionDto (object)SaleDto (object)

Request

JavaScriptCurl

const response = await fetch('//offers/{id}/txapprove', {
    method: 'PATCH',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "txApprove": "text"
    }),
});
const data = await response.json();

Response

{
  "success": true,
  "result": {
    "id": "text",
    "nft": {
      "id": "text",
      "address": "text",
      "chain": "AVAC",
      "name": "text",
      "description": "text",
      "imageUrl": "text",
      "backgroundColor": "text",
      "url": "text",
      "imagePreviewUrl": "text",
      "imageThumbnailUrl": "text",
      "animationUrls": [
        {
          "type": "text",
          "value": "text"
        }
      ],
      "fungible": false,
      "attributes": [
        {
          "type": "text",
          "name": "text",
          "value": "text",
          "displayType": "text"
        }
      ],
      "contract": {
        "chain": "AVAC",
        "address": "text",
        "name": "text",
        "description": "text",
        "symbol": "text",
        "url": "text",
        "imageUrl": "text",
        "media": {
          "array": false,
          "null": false,
          "float": false,
          "valueNode": false,
          "containerNode": false,
          "missingNode": false,
          "object": false,
          "nodeType": "ARRAY",
          "integralNumber": false,
          "short": false,
          "int": false,
          "long": false,
          "double": false,
          "bigDecimal": false,
          "bigInteger": false,
          "textual": false,
          "boolean": false,
          "floatingPointNumber": false,
          "binary": false,
          "pojo": false,
          "number": false
        },
        "verified": false,
        "premium": false,
        "categories": [
          "text"
        ]
      },
      "collectionIdentifier": "text"
    },
    "sellerId": "text",
    "sellerNickname": "text",
    "externalSellerId": "text",
    "sellerAddress": "text",
    "startDate": "2024-05-06T15:47:15.831Z",
    "endDate": "2024-05-06T15:47:15.831Z",
    "type": "AUCTION",
    "status": "NEW",
    "dataToSign": "text",
    "txApprove": "text",
    "txInCustody": "text",
    "createdOn": "2024-05-06T15:47:15.831Z",
    "createdBy": "text",
    "modifiedOn": "2024-05-06T15:47:15.831Z",
    "modifiedBy": "text",
    "signed": false,
    "currency": "USDC",
    "privateOffer": false,
    "seller": {
      "id": "text",
      "nickname": "text",
      "email": "text"
    },
    "price": 0,
    "minimumBid": 0,
    "buyNowPrice": 0,
    "bids": [
      {
        "id": "text",
        "user": {
          "id": "text",
          "nickname": "text",
          "email": "text"
        },
        "amount": 0,
        "offerId": "text",
        "externalUserId": "text",
        "createdOn": "2024-05-06T15:47:15.831Z"
      }
    ],
    "highestBid": {
      "id": "text",
      "user": {
        "id": "text",
        "nickname": "text",
        "email": "text"
      },
      "amount": 0,
      "offerId": "text",
      "externalUserId": "text",
      "createdOn": "2024-05-06T15:47:15.831Z"
    }
  }
}

PUT//offers/{id}/metaTxApprove

Path parameters

id*string

Body

application/json

functionSignature*string

r*string

s*string

v*string

Response

200400401403404405415500

OK

Body

*/*

successboolean

resultone of

AuctionDto (object)SaleDto (object)

Request

JavaScriptCurl

const response = await fetch('//offers/{id}/metaTxApprove', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "functionSignature": "text",
      "r": "text",
      "s": "text",
      "v": "text"
    }),
});
const data = await response.json();

Response

{
  "success": true,
  "result": {
    "id": "text",
    "nft": {
      "id": "text",
      "address": "text",
      "chain": "AVAC",
      "name": "text",
      "description": "text",
      "imageUrl": "text",
      "backgroundColor": "text",
      "url": "text",
      "imagePreviewUrl": "text",
      "imageThumbnailUrl": "text",
      "animationUrls": [
        {
          "type": "text",
          "value": "text"
        }
      ],
      "fungible": false,
      "attributes": [
        {
          "type": "text",
          "name": "text",
          "value": "text",
          "displayType": "text"
        }
      ],
      "contract": {
        "chain": "AVAC",
        "address": "text",
        "name": "text",
        "description": "text",
        "symbol": "text",
        "url": "text",
        "imageUrl": "text",
        "media": {
          "array": false,
          "null": false,
          "float": false,
          "valueNode": false,
          "containerNode": false,
          "missingNode": false,
          "object": false,
          "nodeType": "ARRAY",
          "integralNumber": false,
          "short": false,
          "int": false,
          "long": false,
          "double": false,
          "bigDecimal": false,
          "bigInteger": false,
          "textual": false,
          "boolean": false,
          "floatingPointNumber": false,
          "binary": false,
          "pojo": false,
          "number": false
        },
        "verified": false,
        "premium": false,
        "categories": [
          "text"
        ]
      },
      "collectionIdentifier": "text"
    },
    "sellerId": "text",
    "sellerNickname": "text",
    "externalSellerId": "text",
    "sellerAddress": "text",
    "startDate": "2024-05-06T15:47:15.831Z",
    "endDate": "2024-05-06T15:47:15.831Z",
    "type": "AUCTION",
    "status": "NEW",
    "dataToSign": "text",
    "txApprove": "text",
    "txInCustody": "text",
    "createdOn": "2024-05-06T15:47:15.831Z",
    "createdBy": "text",
    "modifiedOn": "2024-05-06T15:47:15.831Z",
    "modifiedBy": "text",
    "signed": false,
    "currency": "USDC",
    "privateOffer": false,
    "seller": {
      "id": "text",
      "nickname": "text",
      "email": "text"
    },
    "price": 0,
    "minimumBid": 0,
    "buyNowPrice": 0,
    "bids": [
      {
        "id": "text",
        "user": {
          "id": "text",
          "nickname": "text",
          "email": "text"
        },
        "amount": 0,
        "offerId": "text",
        "externalUserId": "text",
        "createdOn": "2024-05-06T15:47:15.831Z"
      }
    ],
    "highestBid": {
      "id": "text",
      "user": {
        "id": "text",
        "nickname": "text",
        "email": "text"
      },
      "amount": 0,
      "offerId": "text",
      "externalUserId": "text",
      "createdOn": "2024-05-06T15:47:15.831Z"
    }
  }
}

Note that in order to move an offer from state NEW to state READY, the offer will need a 2nd update, which is Update offer: Signature.

See How to put an item for sale? for the entire Offer flow.

Note: The order is important. First the TxApprove, then the Signature.

Which TxApprove needs to be done?

The Approve transaction that needs to be done can differ, depending on the specific contract that is being used, or the actions that have already been done.

Types of approvals:

• Meta transaction approval

  • Only a signature is needed for Venly to take the NFT in custody and put it on sale.

• (traditional) transaction approval

  • A (blockchain) transaction needs to be executed on a contract.

• No approval needed (it is already done in the past).

  • The Approve transaction is not always required, when a wallet has approved the market for a specific NFT contract in the past the wallet will not be required to approve the market a second time. More concrete if a user has approved the market to take an NFT of a certain NFT contract into custody he will not have to approve the market next time he wants to sell a different NFT of the same NFT contract.

In the case that no approval is needed the Update offer: TxApprove step can be skipped and moved directly to Update offer: Signature.

Retrieve the correct TxApprove type

To know which TxApprove step that needs to be done, you can call the Get prepared Approve tx endpoint. It contains all the necessary information to perform the approval step.

• When the result set is empty it means the Approve step can be skipped.

• If the result set contains data, then the Approve still needs to happen:

  • If approvalPreparationTransactions is present, you will need to execute a (blockchain) transaction on a contract. See execute a contract call. All data needed to execute the contract call will be present in the response of the prepare Approve tx.

  • If signableMessages is present, you need to sign a specific message. See Sign a message.

pageGet prepared Approve tx

Example

Request

https://api.arkane.market/offers/b91c6f5f-5ebd-4941-99c1-94e9d1cbd9d5/txapprove

Request Body

{
    "txApprove": "0x7c7fe6ffa8100851e00676ebfea524dc6c666e017da67f07ac4f93e48d1329af"
}

Response

{
    "success": true,
    "result": {
        "id": "b91c6f5f-5ebd-4941-99c1-94e9d1cbd9d5",
        "nft": {
            "tokenId": "2",
            "address": "0x492aef91afb79efaa508debbed7b3e21069d13e3",
            "chain": "ETHEREUM",
            "name": "Cauliflower Pizza",
            "description": "Awesome cauliflower crust pizza with cured pepperoni. Found on a BBS in the early 80s.",
            "imageUrl": "https://lh3.googleusercontent.com/0Dw7pMcyX_m7T_6q3zzrvjmYMg-Matgg8c42DTGvviRDI8M7fa3Ot9siVfhzE0gqolLshVp2O6T3QdccmVblMurg7A",
            "url": "",
            "imagePreviewUrl": "https://lh3.googleusercontent.com/0Dw7pMcyX_m7T_6q3zzrvjmYMg-Matgg8c42DTGvviRDI8M7fa3Ot9siVfhzE0gqolLshVp2O6T3QdccmVblMurg7A=s250",
            "imageThumbnailUrl": "https://lh3.googleusercontent.com/0Dw7pMcyX_m7T_6q3zzrvjmYMg-Matgg8c42DTGvviRDI8M7fa3Ot9siVfhzE0gqolLshVp2O6T3QdccmVblMurg7A=s128",
            "attributes": [
                {
                    "traitType": "topping",
                    "value": "cheese",
                    "traitCount": 4
                },
                {
                    "traitType": "crust",
                    "value": "cauliflower",
                    "traitCount": 2
                },
                {
                    "traitType": "topping",
                    "value": "pepperoni",
                    "traitCount": 2
                },
                {
                    "traitType": "level",
                    "value": "7",
                    "traitCount": 1
                },
                {
                    "traitType": "fuel",
                    "value": "3.4",
                    "traitCount": 1
                },
                {
                    "traitType": "cauliflower_power",
                    "value": "80",
                    "displayType": "boost_number",
                    "traitCount": 1
                },
                {
                    "traitType": "bellyfat_increase",
                    "value": "3",
                    "displayType": "boost_percentage",
                    "traitCount": 1
                }
            ],
            "contract": {
                "chain": "ETHEREUM",
                "address": "0x492aef91afb79efaa508debbed7b3e21069d13e3",
                "count": 0,
                "name": "CryptoPizza Shop",
                "description": "In honor of the dude who paid 10k BTC for two large pizzas in 2010, I'm proud to announce the first ever CryptoPizza Shop! Collect these slices - more to be added soon, but these OG CryptoPizza Slices will go down in history!",
                "symbol": "OSC",
                "imageUrl": "https://rinkeby-storage.opensea.io/0x492aef91afb79efaa508debbed7b3e21069d13e3-1561429292.png"
            }
        },
        "sellerId": "7cbc2bd3-b3d7-4d8e-bda8-173e56189f75",
        "sellerAddress": "0xdb7c22EA49EF93F753F2ed4c9E1A2589aC6E7690",
        "startDate": "2020-10-21T14:46:09.252659Z",
        "endDate": "2020-10-31T14:46:09.252674Z",
        "type": "SALE",
        "status": "NEW",
        "dataToSign": "b91c6f5f-5ebd-4941-99c1-94e9d1cbd9d5_0xdb7c22EA49EF93F753F2ed4c9E1A2589aC6E7690_0xb06b3f1e824BD7eFC0BCe584cF6B772dC0Ff7C75_2",
        "txApprove": "0xd5234cc910c382a4807d94b5af3be68f62ecac867bef9a61e984dfad08257a44",
        "createdOn": "2020-10-21T14:46:09.305261Z",
        "createdBy": "7cbc2bd3-b3d7-4d8e-bda8-173e56189f75",
        "price": 25
    }
}