마이크로 서수

미시서수

scure-btc-signer 위에 서수와 비문을 위한 최소 JS 라이브러리입니다.

JS 코드에서 라이브러리로 사용하거나 포함된 CLI 도구를 실행하세요. 비문을 사용하면 BTC 블록체인에 임의의 파일을 업로드할 수 있습니다.

실험적: 철저하게 테스트할 때까지 자금 손실이 발생할 수 있습니다.

용법

npm은 마이크로서수를 설치합니다.

• 비문 만들기
• 타입스크립트 API
• CLI

비문 만들기

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

 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 마이크로서수 ord file.jpg

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

• net: 비트코인 ​​네트워크
• priv: WIF 형식의 탭루트 개인 키는 공개 거래에 사용됩니다. 지갑을 사용하지 마십시오. priv는 새 지갑이어야 합니다. 아무것도 제공되지 않은 경우 임시 키를 생성합니다.
• 복구: WIF 형식의 탭루트 개인 키를 사용하면 전체 등록 비용을 지불하지 않고도 실수로 비문 주소로 전송된 비트코인을 복구할 수 있습니다.
• 압축: brotli로 압축된 비문입니다. 탐험가와 호환됩니다. 기본값=켜짐
• 수수료: 사토시 단위의 비트코인 ​​네트워크 수수료
• addr: 공개 후 비문이 전송될 주소 중요: 첫 번째 sat은 항상 기재됩니다. 일괄 비문은 지원되지 않습니다.

설계

네트워크 코드가 없습니다. 패키지를 더 안전하게 만들지만 개발자 경험이 줄어듭니다.

아마도 자동으로 수수료를 가져올 수 있지만 utxo 선택은 더욱 복잡해질 것입니다. 예를 들어 사용자가 이전에 무언가를 새겼거나 희귀한 서수가 있는 경우 이를 알기 위해 서수 노드에 액세스해야 합니다. 또한 우리는 지갑의 동결된 출력에 대해 아무것도 모릅니다. 이는 지갑 내부에만 있습니다.

명심해야 할 극단적인 경우:

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), LICENSE 파일을 참조하세요.