OIP-04: Chunking Large File


Status: Draft


Given that Bitcoin's block size limitation stands at a maximum of 4MBs, users aiming to inscribe files larger than this limit are compelled to utilize recursive techniques. However, the present-day scenario lacks a uniform standard for identifying inscriptions with recursives.

The enhancement underlined in this proposal aims to establish a standard for embedding instructions with the recursive inscription. These instructions will aid in the "stitching" of recursive inscriptions, ensuring proper reassembly.


  1. Implement a universally-accepted standard for identifying inscriptions using recursives.

  2. Ensure proper reassembly of inscriptions by embedding comprehensive instructions.

Proposed Solution

The solution encompasses metadata detailing the recursive inscriptions, and this metadata is inscribed following the OIP-01 standard.


  1. The creator divides the file and inscribes these partial files.

  2. The creator embeds the recursive inscription together with relevant metadata.

  3. Viewers interpret and reconstruct the full inscription based on the provided metadata.

Metadata Format for Recursive Inscription of Large Files

Outlined below is the JSON format employed for Metadata concerning large file inscriptions:

  "p": "chunks",
  "v": 1,
  "mt": "",
  "iids": [
     // Array of inscription identifiers
  "meta": {
    // Meta data for the inscription


  1. Fields p (protocol) and v (version) are mandatory.

  2. mt denotes the file type (eg: image/webp)

  3. iids is an array storing identifiers of inscriptions used as recursives.

  4. meta encapsulates metadata for the inscription. Eg: grid, width, height can be applied for images.

Example of metadata of Large Images Inscription using recursives

The following example is a recursive inscription of 4 webp images in a grid of 2x2

  "p": "chunks",
  "v": 1,
  "mt": "image/webp",
  "iids": [
  "meta": {
    "grid": "2x2",
    "width": 1024,
    "height": 1024

Tools Incorporating OIP-4

1. Large Images Inscription:

The Ordlify Large Image Inscriptions tool is designed to inscribe sizable images by segmenting and then reassembling them per the OIP-04 standard.

Support & Inquiries

For additional insights and support, do reach out on Twitter via @afxal or @shafiu.

Last updated