Mina Name Protocol (Experiment)

This repository serves as an experiment, and all included implementations will likely be revised at a later point. It serves as a playground to advance the idea of an Inscription-Based Name System for Mina.

Table of Contents

• Mina Name System (Experiment)
  • Table of Contents
  • Explorer Name Service
  • Full Featurelist
    • Operations
    • Single Struct
      • Project
      • Name
      • Sources
      • Roles
    • Batch Update
  • Minimal Featurelist
    • Memo Overview
    • Test
    • Fetch Memo

Explorer Name Service

"To ensure that only the address holder may update the information, a transaction must be broadcast on the Mina blockchain utilizing the memo field to the specified address. To identify this is a name request, the memo must begin with Name: You should send an amount of 0 and only pay the transaction fee. "

Memos are limited to 32 characters that include the prefix.

https://docs.minaexplorer.com/minaexplorer/explorer-name-service

GraphQL Archive Nodes

• Archive Node: https://docs.minaexplorer.com/minaexplorer/berkeley-testnet
• zkIgnite Funding: https://zkignite.minaprotocol.com/zkignite/dev4dev-track-1/funded/suggestion/381

Full Featurelist

Operations

Operations are the core of a command; they define how the command will be handled.

NR	NAME	STRUCT
1	create	single
2	update	single
3	delete	single
4	batch	batch

Single Struct

NR	KEY	REQUIRED	TYPE	OPERATIONS
A	project	true	string
B	name	true	string	create, delete
C	sources	false	array object	create, update, delete
D	roles	false	array object	create, update, delete

Example

{
    "project": "mns::0.01",
    "operation": "create",
    "name": "meow.test",
    "sources": [
        {
            "provider": "ipfs",
            "source": "ipfs://..."
        }
    ],
    "roles": [
        {
            "role": "Owner",
            "address": "B62..."
        }
    ]
}

Project

This key determines which parser is responsible for the command. The provided string includes the following components.

NR	NAME	REGEX	DESCRIPTION
1	project tag	mns	A designated abbreviation for Mina Contract System
2	splitter	::	A splitter separates the project tag from the version number
3	version	\d+\.\d{2}	The version number of the protocol for proper evaluation

Example:

{
    "project": "mns::0.01"
}

Name

The name cannot be updated; it can only be deleted after creation. This field defines the name of the entry.

NR	KEY	REQUIRED	REGEX	ID
1	name	true	\w+\.test	X

Sources

This field can be used to link references to Smart Contracts. Additional fields can be considered, and validation dependencies based on the provider might also be taken into account.

NR	KEY	REQUIRED	REGEX	ID
1	provider	true	ipfs|ord
2	source	true	[.\\d]+	X

Example:

{
    ...
    "sources": [
        {
            "provider": "ipfs",
            "source": "ipfs://..."
        }
        ...
    ]
}

The key "sources" is optional, but if used, 1 and 2 must be passed as a JSON structure.

Roles

Roles can be defined here, allowing for the distribution of data management.

NR	KEY	REQUIRED	REGEX	ID
1	role	true	owner|contributor
2	address	true	^B62[a-km-zA-HJ-NP-Z1-9]{52}$	X

Example

{
    ...
    "roles": [
        {
            "role": "Owner",
            "address": "B62..."
        }
    ]
}

The key "roles" is optional, but if used, 1 and 2 must be passed as a JSON structure.

Batch Update

Here, various operations can be mixed together, saving space while still allowing for efficient reading.

Example:

{
    "project": "mns::0.01",
    "operation": "batch",
    "name": "meow.test",
    "batch": [
        {
            "operation": "create",
            "key": "sources",
            "provider": "ipfs",
            "source": "ipfs://123445556"
        },
        {
            "operation": "update",
            "key": "sources",
            "id": "ipfs://123445556",
            "provider": "ord",
            "source": "ord/123456789"
        },
        {
            "operation": "delete",
            "key": "sources",
            "id": "ipfs://123445556"
        },
        {
            "operation": "create",
            "key": "roles",
            "role": "owner",
            "address": "B62...abc"
        },
        {
            "operation": "update",
            "key": "roles",
            "id": "B62...abc",
            "role": "contributor",
            "address": "B62...xyz"
        },
        {
            "operation": "delete",
            "key": "roles",
            "id": "B62...abc"
        }
    ]
}

Minimal Featurelist

• "Name": [ create, delete ]

Memo Overview

Only 32 bytes are possible

https://mothereff.in/byte-counter

Memo Introduction:

https://garethtdavies.medium.com/prototyping-a-coda-blockchain-explorer-dbe5c12b4ae2

Encoding with bs58:

MinaProtocol/mina#7079 (comment)

Example - E4YfGWVZK4c946WaUWKU1TVBHkjij17A5NK71qnkfgzDEoPfnHzME > aaaa.test

- Module: [base58check](https://pypi.org/project/base58check/)

Test

https://berkeley.minaexplorer.com/transaction/5JtugaKzy5ms55HpVhzBgpDxCAfeFmu2ju11ffWqJAUJpPhztAXJ

Contract

https://berkeley.minaexplorer.com/wallet/B62qkvW2gDNdzwnUtM7Zx8dLA8TRNf9MeuycEs5bL46HVCjnZwNMWh5

User

https://berkeley.minaexplorer.com/wallet/B62qkJ3BSoHtxd7ndHuETioVPEfG4VcNUA7p4x2Y1PfK3dPrgG2qyEa

Fetch Memo

Get Address by Name

Known: Name

• NumericHash 24144640
• Memo: E4ZNHV411wMefbDqatmQPx8ZMZYg3cGHm5nCQ9kqy2mBBngMJ2BzX

query MyQuery {
  events(sortBy: BLOCKHEIGHT_DESC, query: {event_in: "24144640", zkAppCommandHash: {zkappCommand: {accountUpdates: {body: {publicKey: "B62qkvW2gDNdzwnUtM7Zx8dLA8TRNf9MeuycEs5bL46HVCjnZwNMWh5"}}, memo: "E4ZNHV411wMefbDqatmQPx8ZMZYg3cGHm5nCQ9kqy2mBBngMJ2BzX"}}}) {
    zkAppCommandHash {
      zkappCommand {
        accountUpdates {
          body {
            events
            publicKey
          }
        }
        memo
        feePayer {
          body {
            publicKey
          }
        }
      }
      blockHeight
      dateTime
    }
  }
}

Get Name by Address

Known: Address

query MyQuery {
  zkapps(sortBy: BLOCKHEIGHT_DESC, query: {zkappCommand: {feePayer: {body: {publicKey: "B62qkJ3BSoHtxd7ndHuETioVPEfG4VcNUA7p4x2Y1PfK3dPrgG2qyEa"}}, accountUpdates: {body: {publicKey: "B62qkvW2gDNdzwnUtM7Zx8dLA8TRNf9MeuycEs5bL46HVCjnZwNMWh5"}}}}) {
    zkappCommand {
      accountUpdates {
        body {
          events
          publicKey
        }
      }
      memo
    }
  }
}