mikro ordinal

mikro-ordinal

Pustaka JS minimal untuk tata cara dan prasasti di atas scure-btc-signer.

Gunakan sebagai perpustakaan dalam kode JS Anda, atau jalankan alat CLI yang disertakan. Prasasti memungkinkan pengunggahan file acak di blockchain BTC.

Eksperimental: dapat menyebabkan hilangnya dana sampai diuji secara menyeluruh.

Penggunaan

npm instal mikro-ordinal

• Membuat prasasti
• API Skrip Ketik
• CLI

Membuat prasasti

test`) }; const revealPayment = btc.p2tr( undefined, // internalPubKey ordinals.p2tr_ord_reveal(pubKey, [inscription]), // TaprootScriptTree TESTNET, // mainnet or testnet false, // allowUnknownOutputs, safety feature customScripts // how to handle custom scripts ); // We need to send some bitcoins to this address before reveal. // Also, there should be enough to cover reveal tx fee. console.log('Address', revealPayment.address); // 'tb1p5mykwcq5ly7y2ctph9r2wfgldq94eccm2t83dd58k785p0zqzwkspyjkp5' // Be extra careful: it's possible to accidentally send an inscription as a fee. // Also, rarity is only available with ordinal wallet. // But you can parse other inscriptions and create a common one using this. const changeAddr = revealPayment.address; // can be different const revealAmount = 2000n; const fee = 500n; const tx = new btc.Transaction({ customScripts }); tx.addInput({ ...revealPayment, // This is txid of tx with bitcoins we sent (replace) txid: '75ddabb27b8845f5247975c8a5ba7c6f336c4570708ebe230caf6db5217ae858', index: 0, witnessUtxo: { script: revealPayment.script, amount: revealAmount }, }); tx.addOutputAddress(changeAddr, revealAmount - fee, TESTNET); tx.sign(privKey, undefined, new Uint8Array(32)); tx.finalize(); const txHex = hex.encode(tx.extract()); console.log(txHex); // Hex of reveal tx to broadcast const tx2 = btc.Transaction.fromRaw(hex.decode(txHex)); // Parsing inscriptions console.log('parsed', ordinals.parseWitness(tx2.inputs[0].finalScriptWitness)); console.log('vsize', tx2.vsize); // Reveal tx should pay at least this much fee">

 // npm install micro-ordinals @scure/btc-signer @scure/base
import * as btc from '@scure/btc-signer' ;
import * as ordinals from 'micro-ordinals' ;
import { hex , utf8 } from '@scure/base' ;

const TESTNET = btc . utils . TEST_NETWORK ;
const privKey = hex . decode ( '0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a' ) ;
const pubKey = btc . utils . pubSchnorr ( privKey ) ;
const customScripts = [ ordinals . OutOrdinalReveal ] ; // Enable custom scripts outside

// This inscribes on first satoshi of first input (default)
const inscription = {
  tags : {
    contentType : 'application/json' , // can be any format (MIME type)
    // ContentEncoding: 'br', // compression: only brotli supported
  } ,
  body : utf8 . decode ( JSON . stringify ( { some : 1 , test : 2 , inscription : true , in : 'json' } ) ) ,
  // One can use previously inscribed js scripts in html
  // utf8.decode(`test`)
} ;

const revealPayment = btc . p2tr (
  undefined , // internalPubKey
  ordinals . p2tr_ord_reveal ( pubKey , [ inscription ] ) , // TaprootScriptTree
  TESTNET , // mainnet or testnet
  false , // allowUnknownOutputs, safety feature
  customScripts // how to handle custom scripts
) ;

// We need to send some bitcoins to this address before reveal.
// Also, there should be enough to cover reveal tx fee.
console . log ( 'Address' , revealPayment . address ) ; // 'tb1p5mykwcq5ly7y2ctph9r2wfgldq94eccm2t83dd58k785p0zqzwkspyjkp5'

// Be extra careful: it's possible to accidentally send an inscription as a fee.
// Also, rarity is only available with ordinal wallet.
// But you can parse other inscriptions and create a common one using this.
const changeAddr = revealPayment . address ; // can be different
const revealAmount = 2000n ;
const fee = 500n ;

const tx = new btc . Transaction ( { customScripts } ) ;
tx . addInput ( {
  ... revealPayment ,
  // This is txid of tx with bitcoins we sent (replace)
  txid : '75ddabb27b8845f5247975c8a5ba7c6f336c4570708ebe230caf6db5217ae858' ,
  index : 0 ,
  witnessUtxo : { script : revealPayment . script , amount : revealAmount } ,
} ) ;
tx . addOutputAddress ( changeAddr , revealAmount - fee , TESTNET ) ;
tx . sign ( privKey , undefined , new Uint8Array ( 32 ) ) ;
tx . finalize ( ) ;

const txHex = hex . encode ( tx . extract ( ) ) ;
console . log ( txHex ) ; // Hex of reveal tx to broadcast
const tx2 = btc . Transaction . fromRaw ( hex . decode ( txHex ) ) ; // Parsing inscriptions
console . log ( 'parsed' , ordinals . parseWitness ( tx2 . inputs [ 0 ] . finalScriptWitness ) ) ;
console . log ( 'vsize' , tx2 . vsize ) ; // Reveal tx should pay at least this much fee

API Skrip Ketik

 import { Coder } from '@scure/base' ;
import * as P from 'micro-packed' ;
import { ScriptType , OptScript , CustomScript } from '@scure/btc-signer' ;
type Bytes = Uint8Array ;
export declare const InscriptionId : P . Coder < string , Bytes > ;
type TagRaw = {
    tag : Bytes ;
    data : Bytes ;
} ;
declare const TagCoders : {
    pointer : P . CoderType < bigint > ;
    contentType : P . CoderType < string > ;
    parent : P . Coder < string , Uint8Array > ;
    metadata : P . CoderType < any > ;
    metaprotocol : P . CoderType < string > ;
    contentEncoding : P . CoderType < string > ;
    delegate : P . Coder < string , Uint8Array > ;
    rune : P . CoderType < bigint > ;
    note : P . CoderType < string > ;
} ;
export type Tags = Partial < {
    [ K in keyof typeof TagCoders ] : P . UnwrapCoder < ( typeof TagCoders ) [ K ] > ;
} > & {
    unknown ?: [ Bytes , Bytes ] [ ] ;
} ;
export type Inscription = { tags : Tags ; body : Bytes ; cursed ?: boolean ; } ;
type OutOrdinalRevealType = { type : 'tr_ord_reveal' ; pubkey : Bytes ; inscriptions : Inscription [ ] ; } ;
export declare const OutOrdinalReveal : Coder < OptScript , OutOrdinalRevealType | undefined > & CustomScript ;
export declare function parseInscriptions ( script : ScriptType , strict ?: boolean ) : Inscription [ ] | undefined ;
/**
 * Parse inscriptions from reveal tx input witness (tx.inputs[0].finalScriptWitness)
 */
export declare function parseWitness ( witness : Bytes [ ] ) : Inscription [ ] | undefined ;
/**
 * Create reveal transaction. Inscription created on spending output from this address by
 * revealing taproot script.
 */
export declare function p2tr_ord_reveal ( pubkey : Bytes , inscriptions : Inscription [ ] ) : {
    type : string ;
    script : Uint8Array ;
} ;

CLI

npm install -g mikro-ordinal ord file.jpg

Penggunaan: ord [--net mainnet|testnet] [--priv key] [--recovery key] [--compress=on|off] [--fee 10.1] [--addr address]

• bersih: jaringan bitcoin
• priv: kunci pribadi taproot dalam format WIF, akan digunakan untuk mengungkapkan transaksi Jangan gunakan dompet Anda, priv harus yang baru. Kami membuat kunci sementara, jika tidak ada yang disediakan
• pemulihan: kunci pribadi akar tunggang dalam format WIF, dapat digunakan untuk memulihkan bitcoin apa pun yang dikirim ke alamat prasasti secara tidak sengaja tanpa membayar biaya prasasti secara penuh.
• kompres: prasasti dikompres dengan brotli. Kompatibel dengan penjelajah. default=aktif
• biaya: biaya jaringan bitcoin dalam satoshi
• addr: alamat tujuan pengiriman prasasti setelah terungkap Penting: sat pertama selalu tertulis. Prasasti batch tidak didukung.

Desain

Tidak ada kode jaringan. Itu membuat paket lebih aman, namun mengurangi pengalaman pengembang.

Kami mungkin dapat mengambil biaya secara otomatis, tetapi pemilihan utxo akan menjadi lebih rumit. Misalnya jika pengguna sebelumnya menuliskan sesuatu atau memiliki ordinal yang langka, kita memerlukan akses ke node ordinal untuk mengetahuinya. Selain itu, kami tidak tahu apa pun tentang keluaran yang dibekukan di dompet: keluaran tersebut hanya ada di dalam dompet.

Kasus tepi yang perlu diingat:

1. pengguna menambahkan txid/indeks yang salah atau keluar dari aplikasi setelah pengiriman
   • kami mencetak kunci pribadi sementara, pengguna dapat memulai ulang dengan menyediakannya dengan '--priv'
   • selama biaya/jaringan/jalurnya sama, Anda dapat memulai kembali proses
2. pengguna mengirim kurang dari jumlah atau beberapa UTXO.
   • ini sebenarnya lebih sulit, karena pembelanjaan apa pun akan memerlukan biaya pendaftaran penuh
   • untuk ini kami menambahkan recovery

Pengujian

Penjelajah

Gunakan mempool dan ordinalsbot.

Mendapatkan koin testnet

Ada beberapa faucet: uo1, eu, pump

dompet pihak ketiga

Untuk menggunakan burung pipit di mac:

 open /Applications/Sparrow.app --args -n testnet

Lisensi

MIT (c) Paul Miller (https://paulmillr.com), lihat file LISENSI.