ลำดับไมโคร

ไมโครออร์ดินาล

ไลบรารี JS ขั้นต่ำสำหรับลำดับและคำจารึกที่อยู่ด้านบนของ scure-btc-signer

ใช้เป็นไลบรารีในโค้ด JS ของคุณ หรือเรียกใช้เครื่องมือ CLI ที่มีมาให้ คำจารึกอนุญาตให้อัปโหลดไฟล์สุ่มบนบล็อคเชน BTC

การทดลอง: อาจทำให้สูญเสียเงินทุนจนกว่าจะได้รับการทดสอบอย่างละเอียด

การใช้งาน

npm ติดตั้งไมโครออร์ดินาล

• การสร้างจารึก
• TypeScript API
• คลีไอ

การสร้างจารึก

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

TypeScript API

 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 ;
} ;

คลีไอ

npm ติดตั้ง -g micro-ordinals ord file.jpg

การใช้งาน: ord [--net mainnet|testnet] [--คีย์ priv] [--คีย์การกู้คืน] [--compress=on|off] [--ค่าธรรมเนียม 10.1] [--ที่อยู่ addr]

• สุทธิ: เครือข่าย bitcoin
• priv: รหัสส่วนตัว taproot ในรูปแบบ WIF จะถูกใช้สำหรับการเปิดเผยธุรกรรม อย่าใช้กระเป๋าเงินของคุณ priv ควรเป็นอันใหม่ เราสร้างคีย์ชั่วคราว หากไม่มีการระบุไว้
• การกู้คืน: คีย์ส่วนตัว taproot ในรูปแบบ WIF สามารถใช้เพื่อกู้คืน bitcoin ใด ๆ ที่ส่งไปยังที่อยู่จารึกโดยไม่ได้ตั้งใจโดยไม่ต้องจ่ายค่าธรรมเนียมการจารึกเต็มจำนวน
• บีบอัด: จารึกที่บีบอัดด้วย brotli เข้ากันได้กับนักสำรวจ ค่าเริ่มต้น=เปิด
• ค่าธรรมเนียม: ค่าธรรมเนียมเครือข่าย bitcoin เป็น satoshis
• ที่อยู่: ที่อยู่ที่จะส่งจารึกหลังจากเปิดเผย สำคัญ: วันเสาร์แรกจะถูกจารึกไว้เสมอ ไม่รองรับการจารึกเป็นกลุ่ม

ออกแบบ

ไม่มีรหัสเครือข่าย มันทำให้แพ็คเกจปลอดภัยยิ่งขึ้น แต่ลดประสบการณ์ของนักพัฒนาลง

เราอาจดึงค่าธรรมเนียมได้โดยอัตโนมัติ แต่การเลือก utxo จะซับซ้อนมากขึ้น ตัวอย่างเช่น หากผู้ใช้เคยจารึกบางสิ่งไว้หรือมีลำดับที่หายาก เราจำเป็นต้องเข้าถึงโหนดลำดับจึงจะทราบสิ่งนั้น นอกจากนี้ เรายังไม่รู้อะไรเลยเกี่ยวกับเอาท์พุตที่ถูกแช่แข็งในกระเป๋าเงิน: มันอยู่ภายในกระเป๋าเงินเท่านั้น

กรณี Edge ที่ควรคำนึงถึง:

1. ผู้ใช้เพิ่ม txid/index ผิดหรือออกจากแอปพลิเคชันหลังจากส่ง
   • เราพิมพ์คีย์ส่วนตัวชั่วคราว ผู้ใช้สามารถรีสตาร์ทได้โดยระบุ '--priv'
   • หากค่าธรรมเนียม/เครือข่าย/เส้นทางยาวเท่ากัน คุณสามารถเริ่มกระบวนการใหม่ได้
2. ผู้ใช้ส่งน้อยกว่าจำนวนหรือหลาย UTXO
   • นี่เป็นเรื่องยากกว่าจริงๆ เพราะการใช้จ่ายใดๆ จะต้องเสียค่าธรรมเนียมการจารึกเต็มจำนวน
   • สำหรับสิ่งนี้เราเพิ่ม recovery

การทดสอบ

นักสำรวจ

ใช้ mempool และ ordinalsbot

รับเหรียญเทสเน็ต

มีก๊อกน้ำหลายแบบ: uo1, eu, ปั๊ม

กระเป๋าเงินของบุคคลที่สาม

วิธีใช้กระจอกบน mac:

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

ใบอนุญาต

MIT (c) Paul Miller (https://paulmillr.com) ดูไฟล์ใบอนุญาต