{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"IOU","siteUrl":"https://opensource.ripple.com/","meta":[{"name":"google-site-verification","content":"bLwyBi1imklcIuQxZ7JeI_kRF5Mg7yfr6arpEQV2nsE"}],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"The IOU vertical in simpleXRPL issues and manages trust line-based issued currencies."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"iou","__idx":0},"children":["IOU"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IOU"]}," vertical issues and manages trust line-based issued currencies. Each operation acts as the IOU's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["issuer"]}," — the account resolved from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["from"]}," (default: the primary signer's account) signs, and its address is the currency issuer. Callers name their own counterparty (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["holder"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["to"]},") per call."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Method"},"children":["Method"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/simplexrpl/references/verticals/iou/issue"},"children":["issue"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bootstrap a new trust line-based IOU, optionally distributing an opening amount."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/simplexrpl/references/verticals/iou/transfer"},"children":["transfer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Send IOU value to a destination account."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/simplexrpl/references/verticals/iou/authorize"},"children":["authorize"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authorize a holder to hold this IOU."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/simplexrpl/references/verticals/iou/lock"},"children":["lock"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Freeze a holder's trust line (individual + deep freeze)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/simplexrpl/references/verticals/iou/unlock"},"children":["unlock"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Restore a frozen holder's trust line."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/simplexrpl/references/verticals/iou/clawback"},"children":["clawback"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reclaim a holder's balance back to the issuer."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/simplexrpl/references/verticals/iou/buyoffer"},"children":["buyOffer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Place a DEX order to acquire this IOU."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/simplexrpl/references/verticals/iou/selloffer"},"children":["sellOffer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Place a DEX order to sell this IOU."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/simplexrpl/references/verticals/iou/canceloffer"},"children":["cancelOffer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cancel a standing offer."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/simplexrpl/references/verticals/iou/retrieve"},"children":["retrieve"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read a single IOU trust line."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/simplexrpl/references/verticals/iou/list"},"children":["list"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List an account's IOU trust lines."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/simplexrpl/references/verticals/iou/listoffers"},"children":["listOffers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List all open offers in the market for an IOU."]}]}]}]}]}]},"headings":[{"value":"IOU","id":"iou","depth":1}],"frontmatter":{"seo":{"description":"The IOU vertical in simpleXRPL issues and manages trust line-based issued currencies.","title":"IOU"},"labels":["simpleXRPL","SDK"]},"editPage":{"to":"https://github.com/ripple/opensource.ripple.com/tree/main/docs/simpleXRPL/references/verticals/iou/index.md"},"lastModified":"2026-08-26T05:15:32.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/simplexrpl/references/verticals/iou","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}