الترتيبية الدقيقة

الترتيبية الدقيقة

الحد الأدنى من مكتبة JS للأعداد الترتيبية والنقوش الموجودة أعلى scure-btc-signer.

استخدمها كمكتبة في كود JS الخاص بك، أو قم بتشغيل أداة CLI المضمنة. تسمح النقوش بتحميل ملفات عشوائية على BTC blockchain.

تجريبي: يمكن أن يؤدي إلى خسارة الأموال حتى يتم اختباره بدقة.

الاستخدام

npm تثبيت الترتيبية الصغيرة

• إنشاء النقش
• واجهة برمجة تطبيقات تايب سكريبت
• سطر الأوامر

إنشاء النقش

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" style=";text-align:right;direction:rtl">

 // 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

واجهة برمجة تطبيقات تايب سكريبت

 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 install -g micro-ordinals ord file.jpg

الاستخدام: ord [--net mainnet|testnet] [--مفتاح خاص] [--مفتاح الاسترداد] [--compress=on|off] [--fee 10.1] [--عنوان addr]

• صافي: شبكة بيتكوين
• priv: سيتم استخدام المفتاح الخاص Taproot بتنسيق WIF للكشف عن المعاملات. لا تستخدم محفظتك، priv يجب أن يكون جديدًا. نقوم بإنشاء مفتاح مؤقت، إذا لم يتم توفيره
• الاسترداد: يمكن استخدام المفتاح الخاص الجذر بتنسيق WIF لاستعادة أي عملات بيتكوين تم إرسالها إلى عنوان التسجيل عن طريق الصدفة دون دفع رسوم التسجيل كاملة.
• ضغط: نقوش مضغوطة بالبروتلي. متوافق مع المستكشفين. default=on
• الرسوم: رسوم شبكة البيتكوين بالساتوشي
• addr: العنوان الذي سيتم إرسال النقش إليه بعد الكشف هام: يتم دائمًا كتابة أول جلسة. النقوش المجمعة غير مدعومة.

تصميم

لا يوجد رمز الشبكة. فهو يجعل الحزمة أكثر أمانًا، ولكنه يقلل من تجربة المطور.

ربما يمكننا جلب الرسوم تلقائيًا، لكن اختيار utxo سيصبح أكثر تعقيدًا. على سبيل المثال، إذا قام المستخدم بتسجيل شيء ما أو كان لديه ترتيبات نادرة، فنحن بحاجة إلى الوصول إلى العقدة الترتيبية لمعرفة ذلك. كما أننا لا نعرف شيئًا عن المخرجات المجمدة في المحفظة: فهي داخل المحفظة فقط.

حالات الحافة التي يجب وضعها في الاعتبار:

1. أضاف المستخدم txid/index خاطئًا أو قام بإنهاء التطبيق بعد الإرسال
   • نطبع مفتاحًا خاصًا مؤقتًا، ويمكن للمستخدم إعادة التشغيل من خلال تزويده بـ "--priv"
   • نظرًا لأن الرسوم/الشبكة/المسار الطويل هو نفسه، يمكنك إعادة تشغيل العملية
2. أرسل المستخدم أقل من مبلغ أو UTXO متعددة.
   • وهذا في الواقع أصعب، لأن أي إنفاق سيتطلب رسوم تسجيل كاملة
   • لهذا نضيف recovery

اختبار

المستكشفون

استخدم mempool وordinalsbot.

الحصول على عملات testnet

هناك العديد من الحنفيات: uo1، الاتحاد الأوروبي، مضخة

محافظ الطرف الثالث

لاستخدام سبارو على ماك:

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

رخصة

معهد ماساتشوستس للتكنولوجيا (ج) بول ميلر (https://paulmillr.com)، راجع ملف الترخيص.