Skip to main content
Glama

Bernuvia

by com.bernuvia
OverviewDiscussionsAdmin

deposit_data

DEPOSIT: for an order created with prepare_payment, it returns the quote signed by Bernuvia and the calldata of the USDC approve and fundPurchase that YOU sign and send with YOUR linked wallet (msg.sender must be that wallet, not your owner's). The purchase is your owner's: the download and the receipt are theirs. Bernuvia neither signs nor pays the gas. Completing the deposit means accepting the terms on your owner's behalf, including the immediate download (the 14-day right of withdrawal is waived).

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
ordenIdNoDEPRECATED alias of `orderId`: it still works, but use `orderId` (it will be removed in a future round, no date yet). The ordenId (uuid) returned by prepare_payment.
orderIdNoThe ordenId (uuid) returned by prepare_payment.
una_sola_firmaNoDEPRECATED alias of `singleSignature`: it still works, but use `singleSignature` (it will be removed in a future round, no date yet). Optional. true = GASLESS variant (phase 6, only if the platform has it active and the escrow contract supports it): on top of the usual response it returns `unaSolaFirma.typedData`, an EIP-3009 (ReceiveWithAuthorization) authorization of the USDC that you sign with signTypedData, and then you call submit_signed_deposit; Bernuvia sends the transaction and pays the gas. The quote lasts less than in the classic path. Your wallet cannot have code (contracts or EIP-7702).
singleSignatureNoOptional. true = GASLESS variant (phase 6, only if the platform has it active and the escrow contract supports it): on top of the usual response it returns `unaSolaFirma.typedData`, an EIP-3009 (ReceiveWithAuthorization) authorization of the USDC that you sign with signTypedData, and then you call submit_signed_deposit; Bernuvia sends the transaction and pays the gas. The quote lasts less than in the classic path. Your wallet cannot have code (contracts or EIP-7702).
acceptTermsAndImmediateDownloadNoOptional, no longer required. Completing the deposit means accepting Bernuvia's terms, including the immediate download after payment, which waives the 14-day right of withdrawal. If you send it as true, it is also recorded as express consent with the date, the time, the version of the Terms and this order.
acepta_terminos_y_descarga_inmediataNoDEPRECATED alias of `acceptTermsAndImmediateDownload`: it still works, but use `acceptTermsAndImmediateDownload` (it will be removed in a future round, no date yet). Optional, no longer required. Completing the deposit means accepting Bernuvia's terms, including the immediate download after payment, which waives the 14-day right of withdrawal. If you send it as true, it is also recorded as express consent with the date, the time, the version of the Terms and this order.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
gasYesSuggested fees and estimated cost. If the RPC did not respond, it arrives with `nota` only.
redYesThe network where the transactions have to be sent.
estadoYesState of the order once quoted: always "quoted".
saldosYesBalances of the wallet, read on the fly. If the RPC did not respond, it arrives with `nota` only.
walletYesThe wallet that MUST send the transactions (msg.sender == cotizacion.buyer).
importeYesThe deposit amount, in both units.
ordenIdYesThe uuid of the order in Bernuvia.
caducaEnYesExpiry of the quote in ISO 8601.
compraIdYesThe on-chain identifier (bytes32) of the purchase: the same as cotizacion.orderId.
contratosYesAddresses the signatures are made against.
cotizacionYesThe quote signed by Bernuvia: send it back AS IS in submit_signed_deposit, and it is what fundPurchase consumes.
unaSolaFirmaNoOnly with `una_sola_firma: true`: the EIP-3009 authorization you sign so that Bernuvia sends the deposit and pays the gas.
instruccionesYesSteps in text, in order, including the rules about hexadecimal amounts.
transaccionesYesThe transactions of the classic path, IN ORDER: approve (step 1) and fundPurchase (step 2).
segundosRestantesYesSeconds left on the quote at the time of the response.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed85 schema fields changed
    • changedInput schema / properties / acceptTermsAndImmediateDownload / description
      Previous value: -"Opcional; ya no hace falta. Completar el depósito supone aceptar las condiciones de Bernuvia, incluida la descarga inmediata tras el pago, con la que se renuncia al desistimiento de 14 días. Si lo mandas a true, queda además registrado como consentimiento expreso con la fecha, la hora, la versión de los Términos y esta orden. / Optional, no longer required: completing the deposit means accepting the terms, including the immediate download."New value: +"Optional, no longer required. Completing the deposit means accepting Bernuvia's terms, including the immediate download after payment, which waives the 14-day right of withdrawal. If you send it as true, it is also recorded as express consent with the date, the time, the version of the Terms and this order."
    • changedInput schema / properties / acepta_terminos_y_descarga_inmediata / description
      Previous value: -"ALIAS RETIRADO de `acceptTermsAndImmediateDownload`: sigue funcionando, pero usa `acceptTermsAndImmediateDownload` (se quitará en una tanda futura, aún sin fecha). / DEPRECATED alias of `acceptTermsAndImmediateDownload`. Opcional; ya no hace falta. Completar el depósito supone aceptar las condiciones de Bernuvia, incluida la descarga inmediata tras el pago, con la que se renuncia al desistimiento de 14 días. Si lo mandas a true, queda además registrado como consentimiento expreso con la fecha, la hora, la versión de los Términos y esta orden. / Optional, no longer required: completing the deposit means accepting the terms, including the immediate download."New value: +"DEPRECATED alias of `acceptTermsAndImmediateDownload`: it still works, but use `acceptTermsAndImmediateDownload` (it will be removed in a future round, no date yet). Optional, no longer required. Completing the deposit means accepting Bernuvia's terms, including the immediate download after payment, which waives the 14-day right of withdrawal. If you send it as true, it is also recorded as express consent with the date, the time, the version of the Terms and this order."
    • changedInput schema / properties / ordenId / description
      Previous value: -"ALIAS RETIRADO de `orderId`: sigue funcionando, pero usa `orderId` (se quitará en una tanda futura, aún sin fecha). / DEPRECATED alias of `orderId`. El ordenId (uuid) que devolvió prepare_payment."New value: +"DEPRECATED alias of `orderId`: it still works, but use `orderId` (it will be removed in a future round, no date yet). The ordenId (uuid) returned by prepare_payment."
    • changedInput schema / properties / orderId / description
      Previous value: -"El ordenId (uuid) que devolvió prepare_payment."New value: +"The ordenId (uuid) returned by prepare_payment."
    • changedInput schema / properties / singleSignature / description
      Previous value: -"Opcional. true = variante SIN GAS (fase 6, solo si la plataforma la tiene activa y el contrato de custodia la admite): además de lo de siempre devuelve `unaSolaFirma.typedData`, una autorización EIP-3009 (ReceiveWithAuthorization) del USDC que firmas con signTypedData, y después llamas submit_signed_deposit; Bernuvia envía la transacción y paga el gas. La cotización dura menos que en la vía clásica. Tu wallet no puede tener código (contratos o EIP-7702)."New value: +"Optional. true = GASLESS variant (phase 6, only if the platform has it active and the escrow contract supports it): on top of the usual response it returns `unaSolaFirma.typedData`, an EIP-3009 (ReceiveWithAuthorization) authorization of the USDC that you sign with signTypedData, and then you call submit_signed_deposit; Bernuvia sends the transaction and pays the gas. The quote lasts less than in the classic path. Your wallet cannot have code (contracts or EIP-7702)."
    • changedInput schema / properties / una_sola_firma / description
      Previous value: -"ALIAS RETIRADO de `singleSignature`: sigue funcionando, pero usa `singleSignature` (se quitará en una tanda futura, aún sin fecha). / DEPRECATED alias of `singleSignature`. Opcional. true = variante SIN GAS (fase 6, solo si la plataforma la tiene activa y el contrato de custodia la admite): además de lo de siempre devuelve `unaSolaFirma.typedData`, una autorización EIP-3009 (ReceiveWithAuthorization) del USDC que firmas con signTypedData, y después llamas submit_signed_deposit; Bernuvia envía la transacción y paga el gas. La cotización dura menos que en la vía clásica. Tu wallet no puede tener código (contratos o EIP-7702)."New value: +"DEPRECATED alias of `singleSignature`: it still works, but use `singleSignature` (it will be removed in a future round, no date yet). Optional. true = GASLESS variant (phase 6, only if the platform has it active and the escrow contract supports it): on top of the usual response it returns `unaSolaFirma.typedData`, an EIP-3009 (ReceiveWithAuthorization) authorization of the USDC that you sign with signTypedData, and then you call submit_signed_deposit; Bernuvia sends the transaction and pays the gas. The quote lasts less than in the classic path. Your wallet cannot have code (contracts or EIP-7702)."
    • changedOutput schema / properties / caducaEn / description
      Previous value: -"Vencimiento de la cotización en ISO 8601."New value: +"Expiry of the quote in ISO 8601."
    • changedOutput schema / properties / compraId / description
      Previous value: -"El identificador on-chain (bytes32) de la compra: igual a cotizacion.orderId."New value: +"The on-chain identifier (bytes32) of the purchase: the same as cotizacion.orderId."
    • changedOutput schema / properties / contratos / description
      Previous value: -"Direcciones contra las que se firma."New value: +"Addresses the signatures are made against."
    • changedOutput schema / properties / contratos / properties / escrow / description
      Previous value: -"Contrato de custodia (destino del paso 2)."New value: +"Escrow contract (destination of step 2)."
    • changedOutput schema / properties / contratos / properties / usdc / description
      Previous value: -"Contrato del token USDC (destino del paso 1)."New value: +"USDC token contract (destination of step 1)."
    • changedOutput schema / properties / cotizacion / description
      Previous value: -"La cotización firmada por Bernuvia: se devuelve TAL CUAL en submit_signed_deposit y es lo que consume fundPurchase."New value: +"The quote signed by Bernuvia: send it back AS IS in submit_signed_deposit, and it is what fundPurchase consumes."
    • changedOutput schema / properties / cotizacion / properties / amount / description
      Previous value: -"Importe en unidades mínimas de USDC, como cadena decimal."New value: +"Amount in minimal units of USDC, as a decimal string."
    • changedOutput schema / properties / cotizacion / properties / autoReleaseAfter / description
      Previous value: -"Segundos de custodia antes de la liberación automática."New value: +"Seconds in escrow before the automatic release."
    • changedOutput schema / properties / cotizacion / properties / buyer / description
      Previous value: -"Wallet compradora: la única que puede depositar."New value: +"Buyer wallet: the only one that can deposit."
    • changedOutput schema / properties / cotizacion / properties / chainId / description
      Previous value: -"Cadena contra la que se firmó."New value: +"Chain the signature was made against."
    • changedOutput schema / properties / cotizacion / properties / deadline / description
      Previous value: -"Vencimiento de la firma (epoch s): el mismo instante que caducaEn."New value: +"Expiry of the signature (epoch s): the same instant as caducaEn."
    • changedOutput schema / properties / cotizacion / properties / feeBps / description
      Previous value: -"Comisión en puntos básicos (100 = 1 %)."New value: +"Fee in basis points (100 = 1 %)."
    • changedOutput schema / properties / cotizacion / properties / issuedAt / description
      Previous value: -"Emisión (epoch s). Solo en los contratos que lo exigen; ausente en v1."New value: +"Issuance (epoch s). Only in the contracts that require it; absent in v1."
    • changedOutput schema / properties / cotizacion / properties / nonce / description
      Previous value: -"Nonce anti-replay (uint256) como cadena decimal."New value: +"Anti-replay nonce (uint256) as a decimal string."
    • changedOutput schema / properties / cotizacion / properties / orderId / description
      Previous value: -"bytes32 de la compra (igual a compraId)."New value: +"bytes32 of the purchase (the same as compraId)."
    • changedOutput schema / properties / cotizacion / properties / seller / description
      Previous value: -"Wallet de cobro del vendedor."New value: +"The seller's payout wallet."
    • changedOutput schema / properties / cotizacion / properties / signature / description
      Previous value: -"Firma EIP-712 del quoteSigner de Bernuvia (0x…)."New value: +"EIP-712 signature of Bernuvia's quoteSigner (0x…)."
    • changedOutput schema / properties / cotizacion / properties / token / description
      Previous value: -"Dirección del USDC."New value: +"Address of the USDC."
    • changedOutput schema / properties / cotizacion / properties / verifyingContract / description
      Previous value: -"Contrato de custodia del dominio EIP-712."New value: +"Escrow contract of the EIP-712 domain."
    • changedOutput schema / properties / estado / description
      Previous value: -"Estado de la orden tras cotizarla: siempre \"quoted\"."New value: +"State of the order once quoted: always \"quoted\"."
    • changedOutput schema / properties / gas / description
      Previous value: -"Tarifas sugeridas y coste estimado. Si el RPC no respondió, llega solo con `nota`."New value: +"Suggested fees and estimated cost. If the RPC did not respond, it arrives with `nota` only."
    • changedOutput schema / properties / gas / properties / calculadoEn / description
      Previous value: -"Cuándo se estimaron las tarifas (ISO 8601): caducan en ~1 minuto."New value: +"When the fees were estimated (ISO 8601): they expire in ~1 minute."
    • changedOutput schema / properties / gas / properties / maxFeePerGasSugerido / description
      Previous value: -"maxFeePerGas en wei, en DECIMAL (cadena). Por compatibilidad."New value: +"maxFeePerGas in wei, in DECIMAL (string). For compatibility."
    • changedOutput schema / properties / gas / properties / maxFeePerGasSugeridoHex / description
      Previous value: -"El MISMO maxFeePerGas en HEXADECIMAL con 0x: lo que exige el JSON-RPC."New value: +"The SAME maxFeePerGas in HEXADECIMAL with 0x: what the JSON-RPC requires."
    • changedOutput schema / properties / gas / properties / maxPriorityFeePerGasSugerido / description
      Previous value: -"maxPriorityFeePerGas en wei, en DECIMAL (cadena). Por compatibilidad."New value: +"maxPriorityFeePerGas in wei, in DECIMAL (string). For compatibility."
    • changedOutput schema / properties / gas / properties / maxPriorityFeePerGasSugeridoHex / description
      Previous value: -"El MISMO maxPriorityFeePerGas en HEXADECIMAL con 0x: lo que exige el JSON-RPC."New value: +"The SAME maxPriorityFeePerGas in HEXADECIMAL with 0x: what the JSON-RPC requires."
    • changedOutput schema / properties / gas / properties / nota / description
      Previous value: -"Aclaración en texto; es el ÚNICO campo si no se pudieron estimar las tarifas."New value: +"Text clarification; it is the ONLY field if the fees could not be estimated."
    • changedOutput schema / properties / gas / properties / polNecesario / description
      Previous value: -"La misma cifra en POL humano, como cadena decimal."New value: +"The same figure in human POL, as a decimal string."
    • changedOutput schema / properties / gas / properties / polNecesarioWei / description
      Previous value: -"POL que hay que tener para el gas de los dos pasos, en wei y como cadena decimal."New value: +"POL you need to hold for the gas of both steps, in wei and as a decimal string."
    • changedOutput schema / properties / gas / properties / prioridadMinimaGwei / description
      Previous value: -"Prioridad mínima en gwei por debajo de la cual la transacción se atasca en Polygon."New value: +"Minimum priority in gwei below which the transaction gets stuck on Polygon."
    • changedOutput schema / properties / importe / description
      Previous value: -"El importe del depósito, en las dos unidades."New value: +"The deposit amount, in both units."
    • changedOutput schema / properties / importe / properties / unidades / description
      Previous value: -"Unidades mínimas de USDC (6 decimales), como cadena decimal."New value: +"Minimal units of USDC (6 decimals), as a decimal string."
    • changedOutput schema / properties / importe / properties / usdc / description
      Previous value: -"El mismo importe en USDC humano, como cadena decimal."New value: +"The same amount in human USDC, as a decimal string."
    • changedOutput schema / properties / instrucciones / description
      Previous value: -"Pasos en texto, en orden, incluidas las reglas sobre las cantidades hexadecimales."New value: +"Steps in text, in order, including the rules about hexadecimal amounts."
    • changedOutput schema / properties / ordenId / description
      Previous value: -"El uuid de la orden en Bernuvia."New value: +"The uuid of the order in Bernuvia."
    • changedOutput schema / properties / red / description
      Previous value: -"La red donde hay que enviar las transacciones."New value: +"The network where the transactions have to be sent."
    • changedOutput schema / properties / red / properties / chainId / description
      Previous value: -"Id de la cadena (137 = Polygon)."New value: +"Chain id (137 = Polygon)."
    • changedOutput schema / properties / red / properties / nombre / description
      Previous value: -"Nombre legible de la red."New value: +"Readable name of the network."
    • changedOutput schema / properties / saldos / description
      Previous value: -"Saldos de la wallet leídos al vuelo. Si el RPC no respondió, llega solo con `nota`."New value: +"Balances of the wallet, read on the fly. If the RPC did not respond, it arrives with `nota` only."
    • changedOutput schema / properties / saldos / properties / allowanceSuficiente / description
      Previous value: -"¿El allowance cubre el importe? Si es true, omite el paso 1."New value: +"Does the allowance cover the amount? If true, skip step 1."
    • changedOutput schema / properties / saldos / properties / allowanceUnidades / description
      Previous value: -"Allowance concedido al escrow, en unidades mínimas y como cadena decimal."New value: +"Allowance granted to the escrow, in minimal units and as a decimal string."
    • changedOutput schema / properties / saldos / properties / nota / description
      Previous value: -"Aclaración en texto; es el ÚNICO campo si no se pudieron leer los saldos."New value: +"Text clarification; it is the ONLY field if the balances could not be read."
    • changedOutput schema / properties / saldos / properties / polFaltante / description
      Previous value: -"La misma falta en POL humano, como cadena decimal."New value: +"The same shortfall in human POL, as a decimal string."
    • changedOutput schema / properties / saldos / properties / polFaltanteWei / description
      Previous value: -"POL que falta, en wei y como cadena decimal (\"0\" si sobra)."New value: +"POL that is missing, in wei and as a decimal string (\"0\" if there is enough)."
    • changedOutput schema / properties / saldos / properties / polSuficiente / description
      Previous value: -"¿El POL alcanza para el gas de los dos pasos?"New value: +"Is the POL enough for the gas of both steps?"
    • changedOutput schema / properties / saldos / properties / polWei / description
      Previous value: -"Saldo POL nativo en wei, como cadena decimal."New value: +"Native POL balance in wei, as a decimal string."
    • changedOutput schema / properties / saldos / properties / usdcFaltanteUnidades / description
      Previous value: -"USDC que falta, en unidades mínimas y como cadena decimal (\"0\" si sobra)."New value: +"USDC that is missing, in minimal units and as a decimal string (\"0\" if there is enough)."
    • changedOutput schema / properties / saldos / properties / usdcSuficiente / description
      Previous value: -"¿El saldo USDC cubre el importe?"New value: +"Does the USDC balance cover the amount?"
    • changedOutput schema / properties / saldos / properties / usdcUnidades / description
      Previous value: -"Saldo USDC en unidades mínimas, como cadena decimal."New value: +"USDC balance in minimal units, as a decimal string."
    • changedOutput schema / properties / segundosRestantes / description
      Previous value: -"Segundos que le quedan a la cotización al responder."New value: +"Seconds left on the quote at the time of the response."
    • changedOutput schema / properties / transacciones / description
      Previous value: -"Las transacciones de la vía clásica, EN ORDEN: approve (paso 1) y fundPurchase (paso 2)."New value: +"The transactions of the classic path, IN ORDER: approve (step 1) and fundPurchase (step 2)."
    • changedOutput schema / properties / transacciones / items / properties / data / description
      Previous value: -"Calldata ya codificado (0x…)."New value: +"Already encoded calldata (0x…)."
    • changedOutput schema / properties / transacciones / items / properties / descripcion / description
      Previous value: -"Qué hace esa transacción."New value: +"What that transaction does."
    • changedOutput schema / properties / transacciones / items / properties / gasLimitSugerido / description
      Previous value: -"Límite de gas sugerido en DECIMAL (cadena). Se conserva por compatibilidad."New value: +"Suggested gas limit in DECIMAL (string). Kept for compatibility."
    • changedOutput schema / properties / transacciones / items / properties / gasLimitSugeridoHex / description
      Previous value: -"El MISMO límite en HEXADECIMAL con 0x: es el que exige el JSON-RPC (eth_sendTransaction / eth_estimateGas)."New value: +"The SAME limit in HEXADECIMAL with 0x: it is the one the JSON-RPC requires (eth_sendTransaction or eth_estimateGas)."
    • changedOutput schema / properties / transacciones / items / properties / nombre / description
      Previous value: -"Función que se llama: \"approve\" o \"fundPurchase\"."New value: +"Function that is called: \"approve\" or \"fundPurchase\"."
    • changedOutput schema / properties / transacciones / items / properties / omitir / description
      Previous value: -"Solo en el paso 1: true si el allowance ya cubre el importe y puedes saltártelo."New value: +"Only in step 1: true if the allowance already covers the amount and you can skip it."
    • changedOutput schema / properties / transacciones / items / properties / paso / description
      Previous value: -"Orden de envío: 1 approve, 2 fundPurchase."New value: +"Sending order: 1 approve, 2 fundPurchase."
    • changedOutput schema / properties / transacciones / items / properties / to / description
      Previous value: -"Contrato destino de la transacción."New value: +"Destination contract of the transaction."
    • changedOutput schema / properties / transacciones / items / properties / value / description
      Previous value: -"POL nativo a enviar, en HEXADECIMAL con 0x (QUANTITY del JSON-RPC): siempre \"0x0\"."New value: +"Native POL to send, in HEXADECIMAL with 0x (JSON-RPC QUANTITY): always \"0x0\"."
    • changedOutput schema / properties / unaSolaFirma / description
      Previous value: -"Solo con `una_sola_firma: true`: la autorización EIP-3009 que firmas para que Bernuvia envíe el depósito y pague el gas."New value: +"Only with `una_sola_firma: true`: the EIP-3009 authorization you sign so that Bernuvia sends the deposit and pays the gas."
    • changedOutput schema / properties / unaSolaFirma / properties / cancelar / description
      Previous value: -"Cómo retirar la autorización si decides no pagar."New value: +"How to withdraw the authorization if you decide not to pay."
    • changedOutput schema / properties / unaSolaFirma / properties / dominioOrigen / description
      Previous value: -"De dónde salió el dominio EIP-712: \"cadena\" (leído del token) o \"asumido\"."New value: +"Where the EIP-712 domain came from: \"cadena\" (read from the token) or \"asumido\"."
    • changedOutput schema / properties / unaSolaFirma / properties / nonce / description
      Previous value: -"El bytes32 de la autorización. GUÁRDALO: es lo que pide cancel_deposit_authorization."New value: +"The bytes32 of the authorization. SAVE IT: it is what cancel_deposit_authorization asks for."
    • changedOutput schema / properties / unaSolaFirma / properties / siguientePaso / description
      Previous value: -"Qué hacer con la firma."New value: +"What to do with the signature."
    • changedOutput schema / properties / unaSolaFirma / properties / typedData / description
      Previous value: -"El mensaje EIP-712 (ReceiveWithAuthorization) a firmar con signTypedData, SIN tocar ningún campo."New value: +"The EIP-712 message (ReceiveWithAuthorization) to sign with signTypedData, WITHOUT touching any field."
    • changedOutput schema / properties / unaSolaFirma / properties / typedData / properties / domain / description
      Previous value: -"Dominio EIP-712 del USDC (name, version, chainId, verifyingContract)."New value: +"EIP-712 domain of the USDC (name, version, chainId, verifyingContract)."
    • changedOutput schema / properties / unaSolaFirma / properties / typedData / properties / message / description
      Previous value: -"Los valores firmados. Las cantidades van como cadena decimal, no como número."New value: +"The signed values. Amounts go as a decimal string, not as a number."
    • changedOutput schema / properties / unaSolaFirma / properties / typedData / properties / message / properties / from / description
      Previous value: -"Tu wallet vinculada."New value: +"Your linked wallet."
    • changedOutput schema / properties / unaSolaFirma / properties / typedData / properties / message / properties / nonce / description
      Previous value: -"bytes32 de la autorización (digest de la cotización)."New value: +"bytes32 of the authorization (digest of the quote)."
    • changedOutput schema / properties / unaSolaFirma / properties / typedData / properties / message / properties / to / description
      Previous value: -"El contrato de custodia."New value: +"The escrow contract."
    • changedOutput schema / properties / unaSolaFirma / properties / typedData / properties / message / properties / validAfter / description
      Previous value: -"Inicio de la ventana (epoch s), como cadena decimal."New value: +"Start of the window (epoch s), as a decimal string."
    • changedOutput schema / properties / unaSolaFirma / properties / typedData / properties / message / properties / validBefore / description
      Previous value: -"Fin de la ventana (epoch s), como cadena decimal: es el vencimiento de la cotización."New value: +"End of the window (epoch s), as a decimal string: it is the expiry of the quote."
    • changedOutput schema / properties / unaSolaFirma / properties / typedData / properties / message / properties / value / description
      Previous value: -"Importe autorizado en unidades mínimas de USDC, como cadena decimal."New value: +"Authorized amount in minimal units of USDC, as a decimal string."
    • changedOutput schema / properties / unaSolaFirma / properties / typedData / properties / primaryType / description
      Previous value: -"Siempre \"ReceiveWithAuthorization\"."New value: +"Always \"ReceiveWithAuthorization\"."
    • changedOutput schema / properties / unaSolaFirma / properties / typedData / properties / types / description
      Previous value: -"Definición de tipos EIP-712."New value: +"EIP-712 type definitions."
    • changedOutput schema / properties / unaSolaFirma / properties / validAfter / description
      Previous value: -"El mismo validAfter del mensaje (epoch s), como cadena decimal."New value: +"The same validAfter from the message (epoch s), as a decimal string."
    • changedOutput schema / properties / unaSolaFirma / properties / validBefore / description
      Previous value: -"El mismo validBefore del mensaje (epoch s), como cadena decimal."New value: +"The same validBefore from the message (epoch s), as a decimal string."
    • changedOutput schema / properties / wallet / description
      Previous value: -"La wallet que DEBE enviar las transacciones (msg.sender == cotizacion.buyer)."New value: +"The wallet that MUST send the transactions (msg.sender == cotizacion.buyer)."
  2. First observed

TDQS

A4.5/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden of behavioral disclosure. It explains who signs and sends, who owns the resulting purchase, who does not pay gas, the legal acceptance of terms, the waiver of the 14-day withdrawal right, and the gasless path's extra EIP-3009 authorization. This is exceptionally transparent about non-obvious consequences.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Five dense sentences, front-loaded with purpose and signer constraints. The legal waiver, gas responsibility, and gasless variant are all necessary for correct use. It is somewhat long, but every sentence contributes; the structure is appropriate for the complexity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description covers the prerequisite order, signer and wallet requirements, ownership effects, gas-cost location, legal acceptance, and gasless routing. Combined with a rich input schema and output schema, an agent has enough to call it correctly; only auxiliary details like how to confirm platform support are left to other tools.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and every property already has thorough descriptions, including deprecated aliases and phase-6 conditions. The top-level description reinforces orderId's origin and the legal meaning of completing a deposit, but it adds little parameter-level meaning beyond what the input schema already provides.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with 'DEPOSIT' and immediately states what the tool does: it returns the quote signed by Bernuvia and the calldata for USDC approve and fundPurchase. It clearly identifies the resource (an order created with prepare_payment), the action (returns signing/sending payloads), and the distinction from the sibling submit_signed_deposit.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is explicitly anchored to an order created with prepare_payment. The description contrasts the classic path (you sign and send, Bernuvia does not pay gas) with the gasless variant (singleSignature=true → call submit_signed_deposit), and imposes the linked-wallet/msg.sender and wallet-no-code conditions. This gives the agent clear routing between alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Bernuvia toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources