HomeInicio/Docs/FAQ

FAQ

Frequently asked questionsPreguntas frecuentes

The short answers to what people ask first - what Pacta actually is, how the money is protected, and what stops a provider from cheating.

Las respuestas cortas a lo que más se pregunta - qué es Pacta en realidad, cómo se protege el dinero y qué impide que un proveedor haga trampa.

Is this a real product?

It is a working proof of concept. The demo data - the Costa Rican firms, the money on screen - is fictional. But the mechanics underneath are real code: a double-entry ledger, a server-enforced state machine, staking, slashing, and registry verification, all fully implemented and covered by 17 API tests and 11 end-to-end tests.

¿Es un producto real?

Es una prueba de concepto funcional. Los datos del demo - las empresas costarricenses, el dinero en pantalla - son ficticios. Pero la mecánica de fondo es código real: un libro de partida doble, una máquina de estados impuesta en el servidor, staking, slashing y verificación de registros, todo implementado y cubierto por 17 pruebas de API y 11 pruebas de extremo a extremo.

How does escrow protect me?

When an engagement is funded, the buyer's money moves into an escrow account that belongs to that single engagement - the provider cannot touch it, and the buyer cannot quietly pull it back. It is released only when the buyer accepts the proof, or redirected by an arbiter's ruling. Every cent lives on a double-entry, integer-cents ledger, so money can never appear or vanish.

¿Cómo me protege la garantía?

Cuando un engagement se financia, el dinero del comprador entra a una cuenta de garantía que pertenece solo a ese engagement - el proveedor no puede tocarla y el comprador no puede retirarla en silencio. Se libera únicamente cuando el comprador acepta la prueba, o se redirige por el fallo de un árbitro. Cada centavo vive en un libro de partida doble en centavos enteros, así que el dinero nunca puede aparecer ni desaparecer.

What makes a provider "vetted"?

Collateral, not review. A provider becomes vetted by staking real money against its own performance - the badge means "vetted" exactly while its stake balance is above zero. Nobody on a verification team ever signs off. The moment a provider's stake reaches $0, it loses the badge automatically.

¿Qué hace que un proveedor esté "verificado"?

Colateral, no revisión. Un proveedor se vuelve verificado poniendo dinero real como garantía de su propio desempeño - la insignia significa "verificado" exactamente mientras su colateral sea mayor que cero. Nadie en un equipo de verificación firma nada. En el momento en que el colateral de un proveedor llega a $0, pierde la insignia automáticamente.

What happens if a provider cheats?

If a delivery is disputed and the arbiter rules against the provider, its stake is slashed in the buyer's favor: 20% of the contract price on a full-refund ruling, 10% on a split, and 0% when the provider wins. The slash is always bounded by the remaining stake, and a provider drained to $0 loses its vetted status on the spot.

¿Qué pasa si un proveedor hace trampa?

Si una entrega se disputa y el árbitro falla contra el proveedor, su colateral se recorta a favor del comprador: 20% del precio del contrato en un fallo de reembolso total, 10% en una división y 0% cuando el proveedor gana. El recorte siempre está acotado por el colateral restante, y un proveedor vaciado a $0 pierde su estatus de verificado de inmediato.

Why would a provider ever stake money?

For access to agentic demand. Agents preferentially hire vetted providers, and the stake is what unlocks that market - it is a credit line of trust, not a fee. The larger the stake, the more open work the provider is allowed to hold at once, so staking is how a business grows the ceiling on what it can earn. Honesty keeps the stake; the only way to lose it is to lose a dispute.

¿Por qué un proveedor pondría dinero como garantía?

Por acceso a la demanda agéntica. Los agentes contratan de preferencia a proveedores verificados, y el colateral es lo que abre ese mercado - es una línea de crédito de confianza, no una comisión. Cuanto mayor es el colateral, más trabajo abierto puede sostener el proveedor a la vez, así que poner colateral es cómo un negocio sube el techo de lo que puede ganar. La honestidad conserva el colateral; la única forma de perderlo es perder una disputa.

What is the exposure cap and why does it exist?

It is the ceiling on how much open work a provider can hold at any moment, checked whenever a contract is agreed and sized relative to the collateral it has staked and the volume it has already proven. The point is simple - a provider can never hold more open value than it would hurt to lose. That is what makes cheating structurally unprofitable: the most it could run off with is always less than the stake it forfeits plus the future earnings it gives up.

¿Qué es el tope de exposición y por qué existe?

Es el techo de cuánto trabajo abierto puede sostener un proveedor en cualquier momento, revisado cada vez que se acuerda un contrato y dimensionado según el colateral que ha puesto y el volumen que ya ha probado. La idea es simple - un proveedor nunca puede sostener más valor abierto del que le dolería perder. Eso es lo que hace que la trampa sea estructuralmente no rentable: lo máximo con lo que podría huir siempre es menor que el colateral que pierde más los ingresos futuros que sacrifica.

How is work proven?

Fulfillment steps can require registry-anchored proof - a reference into an official public registry, such as a company registry, municipal permits, or the tax authority (for example CR-RN-2026-104512 for an incorporation, or CR-MUNI-SJ-88231 for a municipal permit). The platform checks that the record exists and that its kind matches what the step asked for. Because the anchor points at a public record, the buying agent can - and should - re-verify it independently before releasing payment.

¿Cómo se prueba el trabajo?

Los pasos de cumplimiento pueden exigir prueba anclada a un registro - una referencia a un registro público oficial, como el registro de empresas, permisos municipales o la autoridad tributaria (por ejemplo CR-RN-2026-104512 para una constitución, o CR-MUNI-SJ-88231 para un permiso municipal). La plataforma comprueba que el registro existe y que su tipo coincide con lo que pidió el paso. Como el ancla apunta a un registro público, el agente comprador puede - y debe - reverificarlo de forma independiente antes de liberar el pago.

Can my AI agent really use this autonomously?

Yes. Agents connect over the Model Context Protocol and drive the whole loop - shop, agree, fund, verify, release - without a human clicking. In the bundled demo, the Claude-driven agent chose a staked provider over a cheaper one with zero collateral, and re-verified four registry references before paying. See MCP integration for the tool surface.

¿Mi agente de IA puede usar esto de forma autónoma?

Sí. Los agentes se conectan por el Model Context Protocol y operan el ciclo completo - comprar, acordar, financiar, verificar, liberar - sin que un humano haga clic. En el demo incluido, el agente conducido por Claude eligió a un proveedor con colateral por encima de uno más barato sin garantía, y reverificó cuatro referencias de registro antes de pagar. Consulta Integración MCP para conocer las herramientas.

What happens in a dispute?

A disputed engagement goes to a neutral arbiter, who reviews the delivery and the proof and issues one of three rulings: release (the provider is paid in full), refund (the buyer is made whole), or split (a middle outcome). The ruling both settles the escrow and decides the slash - the losing provider risks its stake, which is exactly why neither side escalates lightly.

¿Qué pasa en una disputa?

Un engagement en disputa pasa a un árbitro neutral, que revisa la entrega y la prueba y emite uno de tres fallos: liberación (se le paga al proveedor por completo), reembolso (se le restituye al comprador) o división (un resultado intermedio). El fallo liquida la garantía y decide el recorte - el proveedor que pierde arriesga su colateral, que es justo por lo que ninguna de las partes escala a la ligera.

Do humans use it too?

Yes. The web dashboard lets a person step into any of the three roles - agent, SMB, or arbiter - and drive an engagement by hand. Agents connect programmatically over MCP; humans do the same work through the same server, just with a UI instead of tool calls.

¿Los humanos también lo usan?

Sí. El panel web permite que una persona asuma cualquiera de los tres roles - agente, negocio o árbitro - y opere un engagement a mano. Los agentes se conectan de forma programática por MCP; los humanos hacen el mismo trabajo a través del mismo servidor, solo que con una interfaz en lugar de llamadas a herramientas.

Where does the money live?

On a double-entry ledger inside the platform, denominated in simulated USD and stored as integer cents - no floating point, so no rounding drift. Every movement debits one account and credits another, so the books always balance. The dollars are fictional in this proof of concept; the accounting that governs them is real.

¿Dónde vive el dinero?

En un libro de partida doble dentro de la plataforma, denominado en USD simulados y guardado como centavos enteros - sin punto flotante, así que sin deriva por redondeo. Cada movimiento debita una cuenta y acredita otra, así que los libros siempre cuadran. Los dólares son ficticios en esta prueba de concepto; la contabilidad que los gobierna es real.

Do you use a blockchain? Can Pacta rewrite history?

Only where it earns its place, and Pacta never requires one. By default funds stay on Pacta's audited internal ledger; settlement sits behind an interface with a USDC vault on Base as the reference on-chain backend, selected with one environment variable (see Settlement backends). For integrity, every agreement is dually signed and every lifecycle event is written to a hash-chained log whose Merkle roots Pacta anchors to Base every 12 hours, and both parties get signed receipts an open-source verifier can check without us. Honest status: the AnchorRegistry is live and source-verified on Base mainnet (0x8663…9de1) and the anchoring service publishes real Merkle roots there; settlement is the piece still ahead, with the reference USDC vault an unaudited testnet backend not yet deployed. We call this tamper-evident and independently verifiable, not trustless. See Anchoring on Base and ADR-001.

¿Usan blockchain? ¿Puede Pacta reescribir el historial?

Solo donde aporta, y Pacta nunca exige una. Por defecto los fondos viven en el libro contable interno auditado de Pacta; la liquidación está detrás de una interfaz con un vault de USDC en Base como backend on-chain de referencia, elegido con una sola variable de entorno (ver Backends de liquidación). Para la integridad, cada acuerdo lo firman ambas partes y cada evento del ciclo de vida se escribe en un registro encadenado por hash cuyas raíces Merkle Pacta ancla en Base cada 12 horas, y ambas partes reciben recibos firmados que un verificador de código abierto puede comprobar sin nosotros. Estado honesto: el AnchorRegistry está en vivo y con su código verificado en Base mainnet (0x8663…9de1) y el servicio de anclaje publica raíces Merkle reales ahí; la liquidación es la pieza que aún falta, con el vault de USDC de referencia como backend de testnet sin auditar, todavía no desplegado. Lo llamamos a prueba de alteraciones y verificable de forma independiente, no "trustless". Ver Anclaje en Base y ADR-001.

Does Pacta require a blockchain?

No. The core protocol is MIT-licensed, domain-agnostic infrastructure and runs with zero blockchain dependencies: on the default ledger settlement backend it needs no wallet, no chain, and no crypto packages, and the full test suite passes with none installed. Base is the reference on-chain implementation, not a requirement - a USDC vault for settlement and an AnchorRegistry for integrity - selected with a single environment variable. This is the design in one line: Base first, with a clean seam for others. See Settlement backends.

¿Pacta requiere una blockchain?

No. El protocolo core es infraestructura de licencia MIT, agnóstica al dominio, y corre con cero dependencias de blockchain: en el backend de liquidación ledger por defecto no necesita billetera, ni cadena, ni paquetes de cripto, y la suite de pruebas completa pasa sin ninguno instalado. Base es la implementación on-chain de referencia, no un requisito - un vault de USDC para la liquidación y un AnchorRegistry para la integridad - elegido con una sola variable de entorno. El diseño en una línea: Base primero, con una costura limpia para otros. Ver Backends de liquidación.

What is anchored on-chain?

Only Merkle roots of the agreement log - nothing else. Each 12-hour anchor publishes one 32-byte root that summarizes that window's log entries, plus the window bounds and a leaf count. No terms text, no evidence, no personal data, and no amounts ever go on-chain; those never leave Pacta, and the log itself stores only hashes and metadata. An anchored root lets a receipt holder prove their agreement's history is intact, and proves nothing about anyone else's data. See Anchoring on Base.

¿Qué se ancla on-chain?

Solo raíces Merkle del registro de acuerdos - nada más. Cada anclaje de 12 horas publica una raíz de 32 bytes que resume las entradas del registro de esa ventana, junto con los límites de la ventana y un conteo de hojas. Ni el texto de los términos, ni la evidencia, ni datos personales, ni montos van jamás on-chain; eso nunca sale de Pacta, y el propio registro solo guarda hashes y metadatos. Una raíz anclada permite a quien tiene un recibo probar que el historial de su acuerdo está intacto, y no prueba nada sobre los datos de nadie más. Ver Anclaje en Base.

What's next on the roadmap?

The honest answer: this is a proof of concept, and the next steps are the ones that make it real. Phase 0 has shipped - cryptographic agreement immutability: dually signed agreements, a hash-chained event log, signed receipts, and an independent verifier, plus the domain-separated Merkle construction and the AnchorRegistry anchoring service. Phase 1 is in progress: the settlement refactor is green (a neutral SettlementBackend interface with a chain-free ledger adapter), the reference USDC EscrowVault is in security review and targets Base Sepolia as an unaudited, TVL-capped testnet backend (not yet deployed), and the AnchorRegistry is now live and source-verified on Base mainnet (0x866316ae68b297cc2b3ed2daaf3cabd4f5e39de1), where the anchoring service publishes real Merkle roots on a public chain. Beyond that: real payment rails in place of the simulated ledger, live registry APIs in place of the demo record set, and more countries and service verticals beyond the Costa Rican sample.

¿Qué sigue en el roadmap?

La respuesta honesta: esto es una prueba de concepto, y los siguientes pasos son los que la vuelven real. La Fase 0 ya está publicada - inmutabilidad criptográfica de los acuerdos: acuerdos firmados por ambas partes, un registro de eventos encadenado por hash, recibos firmados y un verificador independiente, más la construcción Merkle con separación de dominio y el servicio de anclaje AnchorRegistry. La Fase 1 está en progreso: el refactor de liquidación está en verde (una interfaz neutral SettlementBackend con un adaptador de libro sin cadena), el EscrowVault de USDC de referencia está en revisión de seguridad y apunta a Base Sepolia como backend de testnet sin auditar y con tope de TVL (aún no desplegado), y el AnchorRegistry se está desplegando y verificando su código en Base mainnet para que el servicio de anclaje publique raíces reales en una cadena pública. Más allá: rieles de pago reales en lugar del libro simulado, APIs de registro en vivo en lugar del conjunto de registros del demo, y más países y verticales de servicio más allá de la muestra costarricense.

Still have questions? Start with Getting started to run Pacta locally, or read the MCP integration guide to connect an agent. You can also reach us at [email protected].
¿Aún tienes preguntas? Empieza por Primeros pasos para correr Pacta localmente, o lee la guía de Integración MCP para conectar un agente. También puedes escribirnos a [email protected].