Asset Data
Attest Asset Data
Build the transaction that re-attests a market asset data from the current token profile
POST
/
lending-external-securities-v2
/
api
/
markets
/
{market}
/
asset-data
/
attest
curl -X POST "https://api.trusset.org/lending-external-securities-v2/api/markets/0x70a0e25c7b768b87e658348b3b577678a173e038/asset-data/attest" \
-H "X-API-Key: trusset_your_key_here"
const base = 'https://api.trusset.org/lending-external-securities-v2/api/markets';
const headers = { 'X-API-Key': 'trusset_your_key_here', 'Content-Type': 'application/json' };
const build = await fetch(`${base}/${marketAddress}/asset-data/attest`, { method: 'POST', headers });
const { success, data, error } = await build.json();
if (!success) throw new Error(`${error.code}: ${error.message}`);
if (data.divergesAfter) console.warn(data.note);
const tx = await wallet.sendTransaction(data.transaction);
await tx.wait();
await fetch(`${base}/${marketAddress}/asset-data/attest/confirm`, {
method: 'POST',
headers,
body: JSON.stringify({ txHash: tx.hash })
});
{
"success": true,
"data": {
"action": "SIGN_TRANSACTION",
"transaction": {
"to": "0xf1aD12F5698F58badd8a662AcfFcCb067A2Ddb8a",
"data": "0x434134e500000000000000000000000070a0e25c7b768b87e658348b3b577678a173e038ba94f849b5852511dd4cc5a0d2cf10d2edbd51d27a69f4f434db122b5fbb0f1a",
"value": "0",
"chainId": 11155111
},
"functionName": "attestAssetData",
"marketAddress": "0x70a0e25c7b768b87e658348b3b577678a173e038",
"signer": "0x511f527bcee080ac9b88afbf24386baedf393948",
"signerRole": "ISSUER",
"contentHash": "0xba94f849b5852511dd4cc5a0d2cf10d2edbd51d27a69f4f434db122b5fbb0f1a",
"schemaVersion": "1.0.0",
"canonicalJson": "{\"market\":{\"borrowAsset\":\"0x98ad0ca091552e23c564b41c74282e5343d03e8a\",\"chainId\":11155111,\"collateralMode\":\"FREEZE\",\"factory\":\"0xf1ad12f5698f58badd8a662acffccb067a2ddb8a\",\"family\":\"FUNGIBLE\",\"priceSource\":\"NAV\"},\"profile\":{\"documents\":[{\"name\":\"Annual report 2025\",\"uri\":\"https://acme-capital.example/nyf1/annual-report-2025.pdf\"},{\"name\":\"Valuation report Q2 2026\",\"uri\":\"https://acme-capital.example/nyf1/valuation-2026-q2.pdf\"}],\"isin\":\"DE000A0F5UF5\",\"issuerName\":\"ACME Capital AG\",\"jurisdiction\":\"DE\",\"prospectusURI\":\"https://acme-capital.example/nyf1/prospectus.pdf\",\"sector\":\"Real estate\",\"website\":\"https://acme-capital.example\"},\"schemaVersion\":\"1.0.0\",\"token\":{\"assetType\":\"REAL_ESTATE\",\"decimals\":18,\"framework\":\"erc3643\",\"name\":\"Nyala Fund I\",\"symbol\":\"NYF1\",\"tokenAddress\":\"0x5b2e4c9a1d7f38e06b4a92c1f0d83e7a64c5b1d9\",\"totalSupply\":\"250000.0\"}}",
"bundle": {
"schemaVersion": "1.0.0",
"market": {
"chainId": 11155111,
"factory": "0xf1ad12f5698f58badd8a662acffccb067a2ddb8a",
"family": "FUNGIBLE",
"borrowAsset": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"collateralMode": "FREEZE",
"priceSource": "NAV"
},
"token": {
"tokenAddress": "0x5b2e4c9a1d7f38e06b4a92c1f0d83e7a64c5b1d9",
"name": "Nyala Fund I",
"symbol": "NYF1",
"decimals": 18,
"framework": "erc3643",
"assetType": "REAL_ESTATE",
"totalSupply": "250000.0"
},
"profile": {
"issuerName": "ACME Capital AG",
"jurisdiction": "DE",
"sector": "Real estate",
"isin": "DE000A0F5UF5",
"website": "https://acme-capital.example",
"prospectusURI": "https://acme-capital.example/nyf1/prospectus.pdf",
"documents": [
{
"name": "Annual report 2025",
"uri": "https://acme-capital.example/nyf1/annual-report-2025.pdf"
},
{
"name": "Valuation report Q2 2026",
"uri": "https://acme-capital.example/nyf1/valuation-2026-q2.pdf"
}
]
}
},
"previousHash": "0x65ed3a41511863cfbeacd3617041f1ccfcf281ab1a29bd7c08002a15cb427ccb",
"previousVersion": 1,
"nextVersion": 2,
"acknowledged": "0x65ed3a41511863cfbeacd3617041f1ccfcf281ab1a29bd7c08002a15cb427ccb",
"divergesAfter": true,
"note": "The lender of record approved an earlier version. Re-attesting leaves that approval where it is: the two hashes will differ, the market reads as diverged, and the bank sees it that way until it approves this version again.",
"confirmWith": {
"endpoint": "POST /lending-external-securities-v2/api/markets/0x70a0e25c7b768b87e658348b3b577678a173e038/asset-data/attest/confirm",
"field": "txHash"
}
}
}
{
"success": false,
"data": null,
"error": {
"code": "NOT_ATTESTOR",
"message": "Only the issuer wallet the lender of record named at adoption (0x511f527bcee080ac9b88afbf24386baedf393948) may attest asset data on this market, and no verified wallet of this instance is it.",
"details": {
"attestor": "0x511f527bcee080ac9b88afbf24386baedf393948",
"role": "ISSUER"
}
}
}
{
"success": false,
"data": null,
"error": {
"code": "ATTESTATION_CURRENT",
"message": "The asset data that stands on the factory (version 2, 0xba94f849b5852511dd4cc5a0d2cf10d2edbd51d27a69f4f434db122b5fbb0f1a) already equals the bundle the current profile produces. Nothing has changed, so there is nothing to re-attest.",
"details": {
"contentHash": "0xba94f849b5852511dd4cc5a0d2cf10d2edbd51d27a69f4f434db122b5fbb0f1a",
"version": 2
}
}
}
Returns the unsigned
attestAssetData transaction that replaces the market’s standing attestation with the bundle this instance’s token profile produces now. The attestor signs it with its own wallet, then confirms it with Confirm Asset Data Attestation.
The first attestation needs no call here. It travels inside the deployment transaction. Use this endpoint after the issuer edited the token profile, which Get Asset Data reports as profile.changedSinceAttestation: true.
Re-attesting never removes an acknowledgement. If the lender of record approved an earlier version, the two hashes differ once this transaction mines. The market then reads
DIVERGED until the lender of record acknowledges the new version. divergesAfter in the response says so before anything is signed.Who can attest
The caller must pass the market access check described on Get Asset Data. One of this instance’s verified wallets must also be the attestor the factory admits right now:- While the market seeks a lender of record, the wallet that deployed it.
- Once a lender of record adopts it, the issuer wallet that lender named in its adoption terms.
NOT_ATTESTOR, and details names the wallet that can sign. A market whose deployer the factory never recorded is refused with ATTESTOR_UNRECORDED, because nobody can attest on it.
The attestor is read when the transaction is built. If the market is adopted before the transaction mines, authority passes to the named issuer, and a transaction signed by the deployer reverts with NotAttestor.
What gets attested
The bundle is built from this instance’s import of the collateral token: the token facts and the published profile. It is combined with the market’s collateral mode, price source and settlement asset as read from the chain. The rules are those described on Preview Asset Data. A profile that is empty, or a token this instance has not imported, is refused withTOKEN_PROFILE_REQUIRED.
The bytes are stored when the transaction is built, before anyone signs, so Get Asset Data Bundle can serve them by contentHash straight away. A bundle equal to the standing attestation is refused with ATTESTATION_CURRENT, because the transaction would change nothing.
This call takes no body.
Path Parameters
string
required
The market contract address, as 40 hex characters with a
0x prefix.Response Fields
object
Show child attributes
Show child attributes
string
SIGN_TRANSACTION.object
Unsigned transaction,
{ to, data, value, chainId }, targeting the lending factory.string
attestAssetData.string
The market, lowercased.
string
The attestor wallet that must sign.
string
DEPLOYER or ISSUER.string
The hash this transaction attests.
string
Bundle schema,
1.0.0.string
The exact bytes the hash commits to.
object
The same bundle as an object.
string
The attestation this replaces.
null when none stands.integer
The factory’s version count before this transaction.
integer
The version this attestation becomes.
string
The version the lender of record acknowledged, as a hash.
null when none.boolean
true when an acknowledgement exists, so the market reads DIVERGED once this mines.string
What the transaction does to an existing acknowledgement, in plain language.
object
{ endpoint, field } naming the confirm route and the txHash field it takes.curl -X POST "https://api.trusset.org/lending-external-securities-v2/api/markets/0x70a0e25c7b768b87e658348b3b577678a173e038/asset-data/attest" \
-H "X-API-Key: trusset_your_key_here"
const base = 'https://api.trusset.org/lending-external-securities-v2/api/markets';
const headers = { 'X-API-Key': 'trusset_your_key_here', 'Content-Type': 'application/json' };
const build = await fetch(`${base}/${marketAddress}/asset-data/attest`, { method: 'POST', headers });
const { success, data, error } = await build.json();
if (!success) throw new Error(`${error.code}: ${error.message}`);
if (data.divergesAfter) console.warn(data.note);
const tx = await wallet.sendTransaction(data.transaction);
await tx.wait();
await fetch(`${base}/${marketAddress}/asset-data/attest/confirm`, {
method: 'POST',
headers,
body: JSON.stringify({ txHash: tx.hash })
});
{
"success": true,
"data": {
"action": "SIGN_TRANSACTION",
"transaction": {
"to": "0xf1aD12F5698F58badd8a662AcfFcCb067A2Ddb8a",
"data": "0x434134e500000000000000000000000070a0e25c7b768b87e658348b3b577678a173e038ba94f849b5852511dd4cc5a0d2cf10d2edbd51d27a69f4f434db122b5fbb0f1a",
"value": "0",
"chainId": 11155111
},
"functionName": "attestAssetData",
"marketAddress": "0x70a0e25c7b768b87e658348b3b577678a173e038",
"signer": "0x511f527bcee080ac9b88afbf24386baedf393948",
"signerRole": "ISSUER",
"contentHash": "0xba94f849b5852511dd4cc5a0d2cf10d2edbd51d27a69f4f434db122b5fbb0f1a",
"schemaVersion": "1.0.0",
"canonicalJson": "{\"market\":{\"borrowAsset\":\"0x98ad0ca091552e23c564b41c74282e5343d03e8a\",\"chainId\":11155111,\"collateralMode\":\"FREEZE\",\"factory\":\"0xf1ad12f5698f58badd8a662acffccb067a2ddb8a\",\"family\":\"FUNGIBLE\",\"priceSource\":\"NAV\"},\"profile\":{\"documents\":[{\"name\":\"Annual report 2025\",\"uri\":\"https://acme-capital.example/nyf1/annual-report-2025.pdf\"},{\"name\":\"Valuation report Q2 2026\",\"uri\":\"https://acme-capital.example/nyf1/valuation-2026-q2.pdf\"}],\"isin\":\"DE000A0F5UF5\",\"issuerName\":\"ACME Capital AG\",\"jurisdiction\":\"DE\",\"prospectusURI\":\"https://acme-capital.example/nyf1/prospectus.pdf\",\"sector\":\"Real estate\",\"website\":\"https://acme-capital.example\"},\"schemaVersion\":\"1.0.0\",\"token\":{\"assetType\":\"REAL_ESTATE\",\"decimals\":18,\"framework\":\"erc3643\",\"name\":\"Nyala Fund I\",\"symbol\":\"NYF1\",\"tokenAddress\":\"0x5b2e4c9a1d7f38e06b4a92c1f0d83e7a64c5b1d9\",\"totalSupply\":\"250000.0\"}}",
"bundle": {
"schemaVersion": "1.0.0",
"market": {
"chainId": 11155111,
"factory": "0xf1ad12f5698f58badd8a662acffccb067a2ddb8a",
"family": "FUNGIBLE",
"borrowAsset": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"collateralMode": "FREEZE",
"priceSource": "NAV"
},
"token": {
"tokenAddress": "0x5b2e4c9a1d7f38e06b4a92c1f0d83e7a64c5b1d9",
"name": "Nyala Fund I",
"symbol": "NYF1",
"decimals": 18,
"framework": "erc3643",
"assetType": "REAL_ESTATE",
"totalSupply": "250000.0"
},
"profile": {
"issuerName": "ACME Capital AG",
"jurisdiction": "DE",
"sector": "Real estate",
"isin": "DE000A0F5UF5",
"website": "https://acme-capital.example",
"prospectusURI": "https://acme-capital.example/nyf1/prospectus.pdf",
"documents": [
{
"name": "Annual report 2025",
"uri": "https://acme-capital.example/nyf1/annual-report-2025.pdf"
},
{
"name": "Valuation report Q2 2026",
"uri": "https://acme-capital.example/nyf1/valuation-2026-q2.pdf"
}
]
}
},
"previousHash": "0x65ed3a41511863cfbeacd3617041f1ccfcf281ab1a29bd7c08002a15cb427ccb",
"previousVersion": 1,
"nextVersion": 2,
"acknowledged": "0x65ed3a41511863cfbeacd3617041f1ccfcf281ab1a29bd7c08002a15cb427ccb",
"divergesAfter": true,
"note": "The lender of record approved an earlier version. Re-attesting leaves that approval where it is: the two hashes will differ, the market reads as diverged, and the bank sees it that way until it approves this version again.",
"confirmWith": {
"endpoint": "POST /lending-external-securities-v2/api/markets/0x70a0e25c7b768b87e658348b3b577678a173e038/asset-data/attest/confirm",
"field": "txHash"
}
}
}
{
"success": false,
"data": null,
"error": {
"code": "NOT_ATTESTOR",
"message": "Only the issuer wallet the lender of record named at adoption (0x511f527bcee080ac9b88afbf24386baedf393948) may attest asset data on this market, and no verified wallet of this instance is it.",
"details": {
"attestor": "0x511f527bcee080ac9b88afbf24386baedf393948",
"role": "ISSUER"
}
}
}
{
"success": false,
"data": null,
"error": {
"code": "ATTESTATION_CURRENT",
"message": "The asset data that stands on the factory (version 2, 0xba94f849b5852511dd4cc5a0d2cf10d2edbd51d27a69f4f434db122b5fbb0f1a) already equals the bundle the current profile produces. Nothing has changed, so there is nothing to re-attest.",
"details": {
"contentHash": "0xba94f849b5852511dd4cc5a0d2cf10d2edbd51d27a69f4f434db122b5fbb0f1a",
"version": 2
}
}
}
Error Codes
The asset data routes report a validation failure with the first failing rule asmessage and no details list. Every access code from Get Asset Data applies here too.
| Code | HTTP | Cause |
|---|---|---|
VALIDATION_ERROR | 400 | market is not a 0x-prefixed 40-character hex address |
INVALID_ASSET_DATA | 400 | A stored token fact or profile field cannot enter the bundle |
NOT_ATTESTOR | 403 | No verified wallet of this instance is the attestor. details carries attestor and role |
MARKET_NOT_DEPLOYED | 404 | The lending factory returns no deployment for this address |
ATTESTOR_UNRECORDED | 409 | The factory records no deployer for this market, so nobody can attest on it |
ATTESTATION_CURRENT | 409 | The standing attestation already equals the bundle the current profile produces |
FACTORY_UPGRADE_REQUIRED | 409 | The factory implementation predates asset data attestation. Nothing about the market itself changes when it is upgraded |
TOKEN_PROFILE_REQUIRED | 422 | This instance has not imported the collateral token as active, or its profile is empty |
ATTEST_BUILD_FAILED | 500 | The transaction could not be built for a reason the service did not classify |
FACTORY_READ_FAILED | 503 | The factory could not be read. Retry shortly |
MARKET_STATE_UNAVAILABLE | 503 | The market’s settlement asset could not be read, so the bundle could not be built. Retry shortly |
⌘I
curl -X POST "https://api.trusset.org/lending-external-securities-v2/api/markets/0x70a0e25c7b768b87e658348b3b577678a173e038/asset-data/attest" \
-H "X-API-Key: trusset_your_key_here"
const base = 'https://api.trusset.org/lending-external-securities-v2/api/markets';
const headers = { 'X-API-Key': 'trusset_your_key_here', 'Content-Type': 'application/json' };
const build = await fetch(`${base}/${marketAddress}/asset-data/attest`, { method: 'POST', headers });
const { success, data, error } = await build.json();
if (!success) throw new Error(`${error.code}: ${error.message}`);
if (data.divergesAfter) console.warn(data.note);
const tx = await wallet.sendTransaction(data.transaction);
await tx.wait();
await fetch(`${base}/${marketAddress}/asset-data/attest/confirm`, {
method: 'POST',
headers,
body: JSON.stringify({ txHash: tx.hash })
});
{
"success": true,
"data": {
"action": "SIGN_TRANSACTION",
"transaction": {
"to": "0xf1aD12F5698F58badd8a662AcfFcCb067A2Ddb8a",
"data": "0x434134e500000000000000000000000070a0e25c7b768b87e658348b3b577678a173e038ba94f849b5852511dd4cc5a0d2cf10d2edbd51d27a69f4f434db122b5fbb0f1a",
"value": "0",
"chainId": 11155111
},
"functionName": "attestAssetData",
"marketAddress": "0x70a0e25c7b768b87e658348b3b577678a173e038",
"signer": "0x511f527bcee080ac9b88afbf24386baedf393948",
"signerRole": "ISSUER",
"contentHash": "0xba94f849b5852511dd4cc5a0d2cf10d2edbd51d27a69f4f434db122b5fbb0f1a",
"schemaVersion": "1.0.0",
"canonicalJson": "{\"market\":{\"borrowAsset\":\"0x98ad0ca091552e23c564b41c74282e5343d03e8a\",\"chainId\":11155111,\"collateralMode\":\"FREEZE\",\"factory\":\"0xf1ad12f5698f58badd8a662acffccb067a2ddb8a\",\"family\":\"FUNGIBLE\",\"priceSource\":\"NAV\"},\"profile\":{\"documents\":[{\"name\":\"Annual report 2025\",\"uri\":\"https://acme-capital.example/nyf1/annual-report-2025.pdf\"},{\"name\":\"Valuation report Q2 2026\",\"uri\":\"https://acme-capital.example/nyf1/valuation-2026-q2.pdf\"}],\"isin\":\"DE000A0F5UF5\",\"issuerName\":\"ACME Capital AG\",\"jurisdiction\":\"DE\",\"prospectusURI\":\"https://acme-capital.example/nyf1/prospectus.pdf\",\"sector\":\"Real estate\",\"website\":\"https://acme-capital.example\"},\"schemaVersion\":\"1.0.0\",\"token\":{\"assetType\":\"REAL_ESTATE\",\"decimals\":18,\"framework\":\"erc3643\",\"name\":\"Nyala Fund I\",\"symbol\":\"NYF1\",\"tokenAddress\":\"0x5b2e4c9a1d7f38e06b4a92c1f0d83e7a64c5b1d9\",\"totalSupply\":\"250000.0\"}}",
"bundle": {
"schemaVersion": "1.0.0",
"market": {
"chainId": 11155111,
"factory": "0xf1ad12f5698f58badd8a662acffccb067a2ddb8a",
"family": "FUNGIBLE",
"borrowAsset": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"collateralMode": "FREEZE",
"priceSource": "NAV"
},
"token": {
"tokenAddress": "0x5b2e4c9a1d7f38e06b4a92c1f0d83e7a64c5b1d9",
"name": "Nyala Fund I",
"symbol": "NYF1",
"decimals": 18,
"framework": "erc3643",
"assetType": "REAL_ESTATE",
"totalSupply": "250000.0"
},
"profile": {
"issuerName": "ACME Capital AG",
"jurisdiction": "DE",
"sector": "Real estate",
"isin": "DE000A0F5UF5",
"website": "https://acme-capital.example",
"prospectusURI": "https://acme-capital.example/nyf1/prospectus.pdf",
"documents": [
{
"name": "Annual report 2025",
"uri": "https://acme-capital.example/nyf1/annual-report-2025.pdf"
},
{
"name": "Valuation report Q2 2026",
"uri": "https://acme-capital.example/nyf1/valuation-2026-q2.pdf"
}
]
}
},
"previousHash": "0x65ed3a41511863cfbeacd3617041f1ccfcf281ab1a29bd7c08002a15cb427ccb",
"previousVersion": 1,
"nextVersion": 2,
"acknowledged": "0x65ed3a41511863cfbeacd3617041f1ccfcf281ab1a29bd7c08002a15cb427ccb",
"divergesAfter": true,
"note": "The lender of record approved an earlier version. Re-attesting leaves that approval where it is: the two hashes will differ, the market reads as diverged, and the bank sees it that way until it approves this version again.",
"confirmWith": {
"endpoint": "POST /lending-external-securities-v2/api/markets/0x70a0e25c7b768b87e658348b3b577678a173e038/asset-data/attest/confirm",
"field": "txHash"
}
}
}
{
"success": false,
"data": null,
"error": {
"code": "NOT_ATTESTOR",
"message": "Only the issuer wallet the lender of record named at adoption (0x511f527bcee080ac9b88afbf24386baedf393948) may attest asset data on this market, and no verified wallet of this instance is it.",
"details": {
"attestor": "0x511f527bcee080ac9b88afbf24386baedf393948",
"role": "ISSUER"
}
}
}
{
"success": false,
"data": null,
"error": {
"code": "ATTESTATION_CURRENT",
"message": "The asset data that stands on the factory (version 2, 0xba94f849b5852511dd4cc5a0d2cf10d2edbd51d27a69f4f434db122b5fbb0f1a) already equals the bundle the current profile produces. Nothing has changed, so there is nothing to re-attest.",
"details": {
"contentHash": "0xba94f849b5852511dd4cc5a0d2cf10d2edbd51d27a69f4f434db122b5fbb0f1a",
"version": 2
}
}
}