# Ordinal Commands ### Quick References: * [Dry Run Testing](#dry-run-testing) * [1. Normal Inscription](#id-1-normal-inscription) * [2. Normal Inscription and send to specified address](#id-2-normal-inscription-and-send-to-specified-address) * [3. Reduced Padding Inscription](#id-3-reduced-padding-inscription) * [4. Inscription with metadata](#id-4-inscription-with-metadata) * [5. Provenance Inscription](#id-5-provenance-inscription) * [6. Batch Inscription](#id-6-batch-inscription) * [7. Inscribe on a specific sat (must have 2 UTXOs in wallet)](#id-7-inscribe-on-a-specific-sat-must-have-2-utxos-in-wallet) * [8. Start indexing with Satoshi tracking](#id-8-start-indexing-with-sat-tracking) *** #### Dry Run (testing) `--dry-run`Dry run allows you to construct the transaction without signing or broadcasting. This provides a fee estimate and confirms the rest of your command is constructed correctly. `--dry-run` can be added to the end of any commands. Command: `ord wallet inscribe --fee-rate --file "FILE" --dry-run`\ Example: `ord wallet inscribe --fee-rate 10 "D:\Files\1.txt" --dry-run` *** #### 1 Normal Inscription A standard inscription. Command: `ord wallet inscribe --fee-rate --file "FILE"`\ Example: `ord wallet inscribe --fee-rate 10 "D:\Files\1.txt"` *** #### 2 Normal Inscription and send to specified address `--destination
` Inscribe and send to specified address. Command: `ord wallet inscribe --fee-rate --file "FILE" --destination
`\ Example: `ord wallet inscribe --fee-rate 10 --postage 330sats --file "D:\Files\1.txt" --destination bc1pwdreq8nxulu96p2zrxmmfgcnhfg05vlw85clqx22s5qtx9ah9dzshcj4lc` *** #### 3 Reduced Padding Inscription [Example Inscription padded with 330 sats](https://ordinals.com/inscription/a86a426fe273f330238765cd941477fa3f647dc9235cf36ba4c3e8b56064c335i4) `--postage `Inscribe with a specified postage for reduced padding (default is 10k sats). Command: `ord wallet inscribe --fee-rate --postage --file "FILE"`\ Example: `ord wallet inscribe --fee-rate 10 --postage 330sats --file "D:\Files\1.txt"` *** #### 4 Inscription with metadata [Example Inscription](https://ordinals.com/inscription/cadc6c906fcf340452c7ad40ce59dafb207b685026a18606531534f121d6c301i0)\ `--json-metadata `Inscribe with JSON metadata. Command: `ord wallet inscribe --fee-rate --json-metadata --file "FILE"`\ Example: `ord wallet inscribe --fee-rate 10 --json-metadata "D:\Files\metadata.json" --file "D:\Files\1.txt"`
Example Metadata structure ```json { "title": "Unique Digital Artwork", "artist": "Creative Artist", "description": "A unique piece of digital art created by Creative Artist.", "year": 2023, "type": "Digital Art", "tags": ["abstract", "colorful", "modern"], "limited_edition": true, "copy_number": 1, "total_copies": 100 } ```
*** #### 5 Provenance Inscription [Example Parent Inscription](https://ordinals.com/inscription/b03f8f87e64eeab788ad62c3ffe35e9a875c97ca802ec0ae04d932584acdc475i0)\ `--parent ` Inscribe a file with a specified parent inscription ID. Command: `ord wallet inscribe --fee-rate --parent --file "CHILD_FILE"`\ Example: `ord wallet inscribe --fee-rate 10 --parent b03f8f87e64eeab788ad62c3ffe35e9a875c97ca802ec0ae04d932584acdc475i0 --file "D:\Files\1.txt"` *** #### 6 Batch Inscription [Example Batch Inscription](https://ordinals.com/inscription/cadc6c906fcf340452c7ad40ce59dafb207b685026a18606531534f121d6c301i0)\ `--batch "BATCH_FILE"` Perform batch inscriptions by specifying a batch file. Command: `ord wallet inscribe --fee-rate --batch "BATCH_FILE"`\ Example: `ord wallet inscribe --fee-rate 10 --batch "D:\Files\batch.yaml"` [Batch Transaction](https://mempool.space/tx/a86a426fe273f330238765cd941477fa3f647dc9235cf36ba4c3e8b56064c335)
Example .Yaml ```yaml # there are two modes: # - `separate-outputs`: place all inscriptions in separate postage-sized outputs # - `shared-output`: place inscriptions in a single output separated by postage mode: separate-outputs # parent inscription: parent: cadc6c906fcf340452c7ad40ce59dafb207b685026a18606531534f121d6c301i0 # `inscription`: path to inscription contents # `metadata`: inscription metadata (optional) # `metaprotocol`: inscription metaprotocol (optional) inscriptions: - file: "D:/Inscriptions/Batch/1.txt" metadata: title: Batchie description: "1" - file: "D:/Inscriptions/Batch/2.txt" metadata: title: Batchie description: "2" - file: "D:/Inscriptions/Batch/3.txt" metadata: title: Batchie description: "3" - file: "D:/Inscriptions/Batch/4.txt" metadata: title: Batchie description: "4" - file: "D:/Inscriptions/Batch/5.txt" metadata: name: "Batchie" description: "A unique digital collectible from the Batchie series." edition: "5" attributes: - trait_type: "Background" value: "Bitcoin Orange" - trait_type: "Color" value: "BitGod Blue" - trait_type: "Accessory" value: "Fomoji Necklace" - trait_type: "Mood" value: "Contemplative" rarity: "Ultra Rare" ```
*** #### 7 Inscribe on a specific sat (must have 2 utxos in wallet) [Satpoint example transaction](https://mempool.space/tx/bf1af18d129f088353bb0ad37cdcf9f02b25e937583c366120da27eb7719b044#flow=\&vin=0)\ `--satpoint ` Create an inscription on a specific sat in your wallet. Command: `ord wallet inscribe --fee-rate --satpoint --file "FILE"`\ Example (10th sat in that utxo): `ord wallet inscribe --fee-rate 10 --satpoint 5ffab6b75dbfa7830a2d4a8520f13d6c7aa095688616af23c82a4da4c7af2e82:0:10 --file "D:\Files\1.txt"` *** #### 8 Start indexing with Sat tracking `--index-sats index` creates a full sat index allowing the tracking of individual sats. If you already have an index.redb you will need to either rename or delete it first. Command: `ord --index-sats index run` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://franken-1.gitbook.io/ord-guides/ordinal-commands.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.