{"_id":"@blsqui/sdk-web","_rev":"8-646a323e4968fb43a19e82880427e10d","name":"@blsqui/sdk-web","dist-tags":{"latest":"1.0.0"},"versions":{"0.9.0":{"name":"@blsqui/sdk-web","version":"0.9.0","keywords":["blsqui","flow","cadence","flix","web3","sdk"],"author":{"name":"Blsqui"},"license":"MIT","_id":"@blsqui/sdk-web@0.9.0","maintainers":[{"name":"blsqui.dev","email":"blsqui.dev@gmail.com"}],"homepage":"https://github.com/blsqui/BlsquiSDK-Web#readme","bugs":{"url":"https://github.com/blsqui/BlsquiSDK-Web/issues"},"dist":{"shasum":"dbbdd1bbe4daf346b4752fdb93c4efb7a9b691b1","tarball":"https://registry.npmjs.org/@blsqui/sdk-web/-/sdk-web-0.9.0.tgz","fileCount":9,"integrity":"sha512-q8o2jfzpSWaQOYF3g2Vl6FfRLRo+Pq+qixAQ+LOLHutiP/cYzHV06xBQLs0CdDVELRHpHWWjmwX/qYOdYc/GSg==","signatures":[{"sig":"MEQCIEeTOtXxullHj2lBKrwbQ2roOGZoQWY8aE6+jtR0FaRRAiA9jBNJBr8xfoOQNTYnGPUlRbqeKNx1grwZwEDWqfbK1g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":102410},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"gitHead":"83c0e1d0bd284bcc8b4fd475642e53c463e821be","scripts":{"dev":"tsup --watch","build":"tsup","prepublishOnly":"npm run build"},"_npmUser":{"name":"blsqui.dev","email":"blsqui.dev@gmail.com"},"repository":{"url":"git+https://github.com/blsqui/BlsquiSDK-Web.git","type":"git"},"_npmVersion":"11.6.2","description":"Official Web SDK for Blsqui — Flow blockchain Local loopback Auth integration & in-game transaction dialogs.","directories":{},"_nodeVersion":"24.13.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","typescript":"^5.9.3"},"_npmOperationalInternal":{"tmp":"tmp/sdk-web_0.9.0_1788590144011_0.29749059122714905","host":"s3://npm-registry-packages-npm-production"}},"0.9.1":{"name":"@blsqui/sdk-web","version":"0.9.1","keywords":["blsqui","flow","cadence","flix","web3","sdk"],"author":{"name":"Blsqui"},"license":"MIT","_id":"@blsqui/sdk-web@0.9.1","maintainers":[{"name":"blsqui.dev","email":"blsqui.dev@gmail.com"}],"homepage":"https://blsqui.net","bugs":{"url":"https://github.com/blsqui/BlsquiSDK-Web/issues"},"dist":{"shasum":"fde4b3b927de80084f13b253515feac2321ad056","tarball":"https://registry.npmjs.org/@blsqui/sdk-web/-/sdk-web-0.9.1.tgz","fileCount":9,"integrity":"sha512-Nl9B6Sorj73/Kwugs81bXskiPB8Eb2o7+8xrXg7Rxm+unZuROX/IdcFvZWLJngMwbCNijauncjct8l4qPddi6Q==","signatures":[{"sig":"MEYCIQCUKfEU5wTYUeXsyWuFU62MFNAoxXknBizzhIY7lWaSuAIhANs6AnAi5YJbNVy1DIbZeZdR+0GQ8cRZHoc2BxJUKOft","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":100698},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"gitHead":"5ee1651da9566a5f68e5e1bb9c2c0654b7b6250d","scripts":{"dev":"tsup --watch","build":"tsup","prepublishOnly":"npm run build"},"_npmUser":{"name":"blsqui.dev","email":"blsqui.dev@gmail.com"},"repository":{"url":"git+https://github.com/blsqui/BlsquiSDK-Web.git","type":"git"},"_npmVersion":"11.6.2","description":"Official Web SDK for Blsqui — Flow blockchain Local loopback Auth integration & in-game transaction dialogs.","directories":{},"_nodeVersion":"24.13.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","typescript":"^5.9.3"},"_npmOperationalInternal":{"tmp":"tmp/sdk-web_0.9.1_1788673095581_0.5799707952646336","host":"s3://npm-registry-packages-npm-production"}},"0.9.2":{"name":"@blsqui/sdk-web","version":"0.9.2","keywords":["blsqui","flow","cadence","flix","web3","sdk"],"author":{"name":"Blsqui"},"license":"MIT","_id":"@blsqui/sdk-web@0.9.2","maintainers":[{"name":"blsqui.dev","email":"blsqui.dev@gmail.com"}],"homepage":"https://blsqui.net","bugs":{"url":"https://github.com/blsqui/BlsquiSDK-Web/issues"},"dist":{"shasum":"3aa5bf3591f65b7a3337d33f1432f8b697e6f8b4","tarball":"https://registry.npmjs.org/@blsqui/sdk-web/-/sdk-web-0.9.2.tgz","fileCount":9,"integrity":"sha512-MvAHkySLVjjQUzc2UZZMVS+ViI4ZHkjHjxVynV6J/nfURYMlfocGurk2GjCPoDpJhkaqUdzEsL7CaC4HZL/Mbw==","signatures":[{"sig":"MEQCIDVV9cVCYjGSaABR5+XbkpQZhNd0qn248olwQCpYyOilAiAcvtC8w0gBFZWaSXLO9tGo6g/dWGlwwIW5vDIpdtgoQA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":120684},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"gitHead":"a9bb00b005756efc2a14c7d70880434b48f3cdb6","scripts":{"dev":"tsup --watch","build":"tsup","prepublishOnly":"npm run build"},"_npmUser":{"name":"blsqui.dev","email":"blsqui.dev@gmail.com"},"repository":{"url":"git+https://github.com/blsqui/BlsquiSDK-Web.git","type":"git"},"_npmVersion":"11.6.2","description":"Official Web SDK for Blsqui — Flow blockchain Local loopback Auth integration & in-game transaction dialogs.","directories":{},"_nodeVersion":"24.13.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","typescript":"^5.9.3"},"_npmOperationalInternal":{"tmp":"tmp/sdk-web_0.9.2_1788857434067_0.9665461392580115","host":"s3://npm-registry-packages-npm-production"}},"0.9.3":{"name":"@blsqui/sdk-web","version":"0.9.3","keywords":["blsqui","flow","cadence","flix","web3","sdk"],"author":{"name":"Blsqui"},"license":"MIT","_id":"@blsqui/sdk-web@0.9.3","maintainers":[{"name":"blsqui.dev","email":"blsqui.dev@gmail.com"}],"homepage":"https://blsqui.net","bugs":{"url":"https://github.com/blsqui/BlsquiSDK-Web/issues"},"dist":{"shasum":"b87b4352f7985e793ffaa661de2773bb2eda295c","tarball":"https://registry.npmjs.org/@blsqui/sdk-web/-/sdk-web-0.9.3.tgz","fileCount":9,"integrity":"sha512-Ec4dtbgb2c7xrqQZ3N4xPO0Ys/G0LpLrc6Us9fYcEI5QMpodQbIbcvMZGHts6s8nSRuovAhBuTDzvySH/jXawQ==","signatures":[{"sig":"MEUCIQCqH3+aX5ADdyi3oB08Ci8Fr327ju7ZWwWlQx3l0oPtEAIgTptJ9f9hRZy+300TnncsBve0069s2TvgdkTxrxA4DMk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":120953},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"gitHead":"84b1ef4854381b8e20cd41fc12791f4873459efa","scripts":{"dev":"tsup --watch","build":"tsup","prepublishOnly":"npm run build"},"_npmUser":{"name":"blsqui.dev","email":"blsqui.dev@gmail.com"},"repository":{"url":"git+https://github.com/blsqui/BlsquiSDK-Web.git","type":"git"},"_npmVersion":"11.6.2","description":"Official Web SDK for Blsqui — Flow blockchain Local loopback Auth integration & in-game transaction dialogs.","directories":{},"_nodeVersion":"24.13.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","typescript":"^5.9.3"},"_npmOperationalInternal":{"tmp":"tmp/sdk-web_0.9.3_1788860645297_0.4614994854979255","host":"s3://npm-registry-packages-npm-production"}},"0.9.4":{"name":"@blsqui/sdk-web","version":"0.9.4","keywords":["blsqui","flow","cadence","flix","web3","sdk"],"author":{"name":"Blsqui"},"license":"MIT","_id":"@blsqui/sdk-web@0.9.4","maintainers":[{"name":"blsqui.dev","email":"blsqui.dev@gmail.com"}],"homepage":"https://blsqui.net","bugs":{"url":"https://github.com/blsqui/BlsquiSDK-Web/issues"},"dist":{"shasum":"481e6277a20a4a550cda869db0d7c4d2399175ad","tarball":"https://registry.npmjs.org/@blsqui/sdk-web/-/sdk-web-0.9.4.tgz","fileCount":9,"integrity":"sha512-eFY5BAqLEbtPb+8PqLibvBDJoVxRdipIQlcCzem1e4j6LkK4MuetfSS7X3JE+7wJCtTFXRsG/g6Pw31cPBEcKA==","signatures":[{"sig":"MEYCIQDHpL0ErUvdcwlXgTi40UvsIvOeFKyKCeioyMny2Ey/jgIhAKakC4V7NY0txfUhA1RVUjRsYiuAlMUL29jxx3dhra1z","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":120949},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"gitHead":"783eeedba99052d38a428c02700419770958de89","scripts":{"dev":"tsup --watch","build":"tsup","prepublishOnly":"npm run build"},"_npmUser":{"name":"blsqui.dev","email":"blsqui.dev@gmail.com"},"repository":{"url":"git+https://github.com/blsqui/BlsquiSDK-Web.git","type":"git"},"_npmVersion":"11.6.2","description":"Official Web SDK for Blsqui — Flow blockchain Local loopback Auth integration & in-game transaction dialogs.","directories":{},"_nodeVersion":"24.13.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","typescript":"^5.9.3"},"_npmOperationalInternal":{"tmp":"tmp/sdk-web_0.9.4_1788872557238_0.2969573156258143","host":"s3://npm-registry-packages-npm-production"}},"0.9.6":{"name":"@blsqui/sdk-web","version":"0.9.6","keywords":["blsqui","flow","cadence","flix","web3","sdk"],"author":{"name":"Blsqui"},"license":"MIT","_id":"@blsqui/sdk-web@0.9.6","maintainers":[{"name":"blsqui.dev","email":"blsqui.dev@gmail.com"}],"homepage":"https://blsqui.net","bugs":{"url":"https://github.com/blsqui/BlsquiSDK-Web/issues"},"dist":{"shasum":"39da87ffb03f8af68e800301076dc2a9903a3f31","tarball":"https://registry.npmjs.org/@blsqui/sdk-web/-/sdk-web-0.9.6.tgz","fileCount":9,"integrity":"sha512-GWtxIjPGTaXQaBBhkHwFZDQ+Q8fNZSsEvmn0EmwLSCWTAICS+Dijat4wOOpLhIh48SYeHUHbNxsY27HmvI8Jag==","signatures":[{"sig":"MEUCIFPX2W7xpQAXYhOd5F47a2z4JcjPzAqtPr5bKN2X6gVvAiEA0Cj49k3S9tj0efQ73kmyOJ8IIN9tJ/MjRJlnbbQOOI4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":121377},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"gitHead":"78a8df9114d995ffa7a6e5fae6760812253e672b","scripts":{"dev":"tsup --watch","build":"tsup","prepublishOnly":"npm run build"},"_npmUser":{"name":"blsqui.dev","email":"blsqui.dev@gmail.com"},"repository":{"url":"git+https://github.com/blsqui/BlsquiSDK-Web.git","type":"git"},"_npmVersion":"11.6.2","description":"Official Web SDK for Blsqui — Flow blockchain Local loopback Auth integration & in-game transaction dialogs.","directories":{},"_nodeVersion":"24.13.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","typescript":"^5.9.3"},"_npmOperationalInternal":{"tmp":"tmp/sdk-web_0.9.6_1788920791574_0.025209172654564016","host":"s3://npm-registry-packages-npm-production"}},"0.9.7":{"name":"@blsqui/sdk-web","version":"0.9.7","keywords":["blsqui","flow","cadence","flix","web3","sdk"],"author":{"name":"Blsqui"},"license":"MIT","_id":"@blsqui/sdk-web@0.9.7","maintainers":[{"name":"blsqui.dev","email":"blsqui.dev@gmail.com"}],"homepage":"https://blsqui.net","bugs":{"url":"https://github.com/blsqui/BlsquiSDK-Web/issues"},"dist":{"shasum":"a2fd2c75058e9320ce711b9ca971deafc0e90958","tarball":"https://registry.npmjs.org/@blsqui/sdk-web/-/sdk-web-0.9.7.tgz","fileCount":9,"integrity":"sha512-FSi8Ze5b6BsBB1y22eHv5QhFEg4ft8kehTjZyVpMlz5mocusJYvNqvKf7/3T4hbPj3Go9h6zebio2D3/faZ53g==","signatures":[{"sig":"MEUCIQCV25grZYSt4qOcGpVpJZrdrsivo/IQC5KL+9SiWKSejgIgSUuIwFCdMOM2swqw/EV5zL438HOMwMqFwG0lka7vCUA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":121137},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"gitHead":"5fb2e8869a12eb4c0f358988f4c107e82ad9e1f8","scripts":{"dev":"tsup --watch","build":"tsup","prepublishOnly":"npm run build"},"_npmUser":{"name":"blsqui.dev","email":"blsqui.dev@gmail.com"},"repository":{"url":"git+https://github.com/blsqui/BlsquiSDK-Web.git","type":"git"},"_npmVersion":"11.6.2","description":"Official Web SDK for Blsqui — Flow blockchain Local loopback Auth integration & in-game transaction dialogs.","directories":{},"_nodeVersion":"24.13.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","typescript":"^5.9.3"},"_npmOperationalInternal":{"tmp":"tmp/sdk-web_0.9.7_1788924480936_0.5086975560093083","host":"s3://npm-registry-packages-npm-production"}},"1.0.0":{"_id":"@blsqui/sdk-web@1.0.0","bugs":{"url":"https://github.com/blsqui/BlsquiSDK-Web/issues"},"dist":{"shasum":"e6a33f584384d59dd122bdae5f66db3f7c7c2b52","tarball":"https://registry.npmjs.org/@blsqui/sdk-web/-/sdk-web-1.0.0.tgz","fileCount":9,"integrity":"sha512-+vPo/Qpoz5QvabLPoFXuAPdV5cNhmmrAismb8zHVM9UASYSYRKdk/HfqzRo4H36fI1yL5+c8YdVBZMJAT5i5qg==","signatures":[{"sig":"MEUCIQD+qo9VB5ouwFRAmty/k0lwKy4LG6XTz7qTRpYm0rHYiAIgIvCquxYfuh1hWNFjZlamPR/GU99LT/nlTIlJYHOEgZk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIB2niWfShkP61jveW3eQXNZqD2C6fhjSlJD6axxcW2fQAiAaA7iyqvOSZ8X4hvzKSHF0ByxQV90QSnBp5Z73hpEsRA=="}],"unpackedSize":125453},"main":"./dist/index.cjs","name":"@blsqui/sdk-web","type":"module","types":"./dist/index.d.ts","author":{"name":"Blsqui"},"module":"./dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"gitHead":"5fb2e8869a12eb4c0f358988f4c107e82ad9e1f8","license":"MIT","scripts":{"dev":"tsup --watch","build":"tsup","prepublishOnly":"npm run build"},"version":"1.0.0","_npmUser":{"name":"blsqui.dev","email":"blsqui.dev@gmail.com"},"homepage":"https://blsqui.net","keywords":["blsqui","flow","cadence","flix","web3","sdk"],"repository":{"url":"git+https://github.com/blsqui/BlsquiSDK-Web.git","type":"git"},"_npmVersion":"11.6.2","description":"Official Web SDK for Blsqui — Flow blockchain Local loopback Auth integration & in-game transaction dialogs.","directories":{},"maintainers":[{"name":"blsqui.dev","email":"blsqui.dev@gmail.com"}],"_nodeVersion":"24.13.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","typescript":"^5.9.3"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk-web_1.0.0_1789794543895_0.07148843139852601"}}},"time":{"created":"2026-09-05T06:35:43.827Z","modified":"2026-09-19T05:09:04.163Z","0.9.0":"2026-09-05T06:35:44.161Z","0.9.1":"2026-09-06T05:38:15.745Z","0.9.2":"2026-09-08T08:50:34.190Z","0.9.3":"2026-09-08T09:44:05.409Z","0.9.4":"2026-09-08T13:02:37.382Z","0.9.6":"2026-09-09T02:26:31.702Z","0.9.7":"2026-09-09T03:28:01.092Z","1.0.0":"2026-09-19T05:09:03.994Z"},"bugs":{"url":"https://github.com/blsqui/BlsquiSDK-Web/issues"},"author":{"name":"Blsqui"},"license":"MIT","homepage":"https://blsqui.net","keywords":["blsqui","flow","cadence","flix","web3","sdk"],"repository":{"url":"git+https://github.com/blsqui/BlsquiSDK-Web.git","type":"git"},"description":"Official Web SDK for Blsqui — Flow blockchain Local loopback Auth integration & in-game transaction dialogs.","maintainers":[{"name":"blsqui.dev","email":"blsqui.dev@gmail.com"}],"readme":"# @blsqui/sdk-web\n\n[![npm version](https://img.shields.io/npm/v/@blsqui/sdk-web.svg)](https://www.npmjs.com/package/@blsqui/sdk-web)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n[![Flow Blockchain](https://img.shields.io/badge/Flow-Blockchain-00EF8B?logo=flow&logoColor=black)](https://flow.com/)\n\nOfficial Web SDK for **Blsqui** — Enabling Flow blockchain Passkey authentication, FLIX execution, and in-game transaction dialogs for web games and interactive applications.\n\n`@blsqui/sdk-web` is a zero-dependency, framework-agnostic TypeScript library that runs smoothly across Svelte, React, Vue, Vanilla JS, and canvas game engines (Pixi.js, Phaser, Three.js, Babylon.js).\n\n---\n\n## ⚡ Features\n\n- **Built-in In-Game Dialog:** Pre-styled, responsive confirmation modal with built-in Cancel button and OK authorization flow.\n- **Passkey / WebAuthn Native Support:** Provides both dedicated popup (`tab`) and embedded (`iframe`) display modes to navigate Safari ITP and cross-origin WebAuthn restrictions seamlessly.\n- **FLIX Ready:** Built on Flow Interaction Templates (FLIX) for secure, human-readable transaction validation.\n\n---\n\n## 📦 Installation\n\n```bash\nnpm install @blsqui/sdk-web\n```\nOr using pnpm / yarn:\n```bash\npnpm add @blsqui/sdk-web\n# or\nyarn add @blsqui/sdk-web\n```\n\n---\n\n# 📖 Usage\n\n## 1. Zero-Config Tournament Entry (Default Modal)\n\nBy default, @blsqui/sdk-web includes a ready-to-use tournament entry confirmation dialog presets for Testnet (10 FLOW entry):\n\n```ts\nimport { BlsquiSDK } from '@blsqui/sdk-web';\n\n// デフォルト確認モーダルを表示し、(10 FLOW entryの)トランザクション確定までポーリングを実施します\nconst result = await BlsquiSDK.requestTransaction();\n\n// トランザクション結果の判定\nif (result.status === 'SEALED') {\n  console.log('エントリーが確定しました！ TX ID:', result.txId, 'プレイヤーアドレス:', result.payer, 'トランザクション照会用識別番号 (256-bit):', result.nonce);\n} else if (result.status === 'CANCELED') {\n  console.log('ユーザーにより処理がキャンセルされました。');\n} else {\n  // トランザクション実行エラー（残高不足等）またはタイムアウト(FAILED or EXPIRED or TIMEOUT)\n  console.warn(`トランザクションが終了しました（ステータス: ${result.status}）:`, result.error || result.errorMessage);\n}\n```\n\n## 2. Custom FLIX ID, Mainenet setting, Vervose setting and Custome modal use\n\nIf your game already provides its own UI (e.g. inventory screen, garage shop, or custom canvas HUD), set `useDefaultModal: false` to bypass the built-in modal and trigger transactions directly:\n\n```ts\nimport { BlsquiSDK } from '@blsqui/sdk-web';\n\nconst result = await BlsquiSDK.requestTransaction({\n  useDefaultModal: false,                     // 独自UIを使用します\n  isTestnet: false,                           // Mainnetで実行します\n  verbose: true,                              // コンソールにログを出力します\n  flixId: 'your-registered-flix-template-id', // FLIX IDを指定します。\n  args: {\n    to: '0x1234567890abcdef'                  // FLIXの引数を指定します\n  }\n});\n\nif (result.status === 'SEALED') {\n  applyNitroBoostToVehicle();\n}\n```\n\n## 3. Display Modes: Popup (tab) vs Embedded (iframe)\n\nCross-origin Passkeys (WebAuthn) have varying security and storage restrictions across browsers (specifically Safari / iOS WebKit). @blsqui/sdk-web gives you full control over how the signing screen is presented:\n\n```ts\n// ユーザーのリアクション（ボタンのクリックイベント）からSDK呼び出しまでの間に非同期処理を挟むとポップアップブロッカーが働く可能性がありますので、非同期処理はユーザーのアクション前に実施をお願いします。\nconst result = await BlsquiSDK.requestTransaction({\n  // Option 1: 'tab' (Default)\n  // Opens a centered popup window. Guarantees 100% native Passkey / Face ID / Touch ID\n  // compatibility across Safari, iOS, Chrome, and Android.\n  displayMode: 'tab', // IFrameではなくポップアップ(デスクトップ環境)/ 別タブ(モバイル環境)で表示します。\n\n  // Option 2: 'iframe'\n  // Directly embeds an iframe modal overlay into your game viewport.\n  // Ideal for desktop Chromium browsers.\n  // displayMode: 'iframe',\n});\n```\n\n## 4. Customizing Built-in Modal Texts & Localization\n\nYou can customize the emoji icon, header title, description text, and button labels of the built-in confirmation dialog via `modalContent`. This is ideal for internationalization (i18n) or non-tournament purchases (e.g. skin shops, battle passes, or energy refills):\n\n```ts\nimport { BlsquiSDK } from '@blsqui/sdk-web';\n\nconst result = await BlsquiSDK.requestTransaction({\n  useDefaultModal: true,\n  isTestnet: true,\n  // 組み込みモーダルのテキスト・アイコンをカスタマイズできます\n  modalContent: {\n    icon: '🎟️',\n    title: 'シーズンパス購入',\n    leadText: 'シーズン1：サイバーパスをアンロックしますか？',\n    subText: '購入費用（5 FLOW）の送金承認が必要です。',\n    confirmLabel: '購入する',\n    cancelLabel: 'Maybe Later'\n  },\n  flixId: 'your-registered-flix-template-id',\n  args: {\n    to: '0xa090f900023d6d34',\n    itemId: 'season_pass_s1'\n  }\n});\n\nif (result.status === 'SEALED') {\n  console.log('🎉 シーズンパスのアンロックが完了しました！ TX:', result.txId);\n}\n```\n\n---\n\n## ⚙️ Configuration Reference\n\n#### `TransactionOptions`\n\n| Parameter | Type | Default | Description |\n| --- | --- | --- | --- |\n| `isTestnet` | `boolean` | `true` | When `true`, connects to Flow Testnet (`lab.blsqui.net`). When `false`, connects to Flow Mainnet (`wallet.blsqui.net`). |\n| `useDefaultModal` | `boolean` | `true` | Whether to render the built-in in-game confirmation dialog. |\n| `displayMode` | `'tab' \\| 'iframe'` | `'tab'` | Target container for the signer screen. `'tab'` opens a dedicated popup; `'iframe'` mounts an in-page overlay. |\n| `flixId` | `string` | Default Fee Template | The FLIX (Flow Interaction Template) identifier. Defaults to the standard 10 FLOW entry template. |\n| `args` | `Record<string, string \\| number>` | `undefined` | Key-value arguments passed into the Cadence interaction. (e.g. `{\"to\": \"0x...\"}`). |\n| `verbose` | `boolean` | `false` | When `true`, outputs detailed debug and polling logs to the browser console. |\n| `modalContent` | `ModalContentConfig` | `undefined` | Custom titles, leads, labels, and icon emojis for the default dialog. |\n\n#### `ModalContentConfig`\n\n| Field | Type | Default | Description |\n| --- | --- | --- | --- |\n| `icon` | `string` | `'🏆'` | Emoji icon or character displayed in the modal header badge. |\n| `title` | `string` | `'Tournament Entry'` | Main header text of the dialog. |\n| `leadText` | `string` | `'Enter the tournament?'` | Primary lead headline prompting the player. |\n| `subText` | `string` | `'Requires 10 FLOW entry fee.'` | Detailed explanation or transaction summary. |\n| `confirmLabel` | `string` | `'OK'` | Label for the positive confirmation button. |\n| `cancelLabel` | `string` | `'Cancel'` | Label for the dismiss/cancel button. |\n| `pendingConfirmLabel` | `string` | `'Connecting...'` | Label shown on the disabled confirm button while waiting for transaction signing. |\n| `pendingCancelLabel` | `string` | `'Cancel'` | Label shown on the cancel/abort button while the transaction is in progress. |\n\n#### `TransactionResult`\n```bash\ninterface TransactionResult {\n  status: 'SEALED' | 'EXECUTED' | 'FINALIZED' | 'PENDING' | 'EXPIRED' | 'FAILED' | 'TIMEOUT' | 'CANCELED';\n  txId?: string;\n  nonce: string;\n  errorMessage?: string | null;\n  error?: string;\n  payer?: string;\n  to?: string;\n  amount?: string;\n  token?: string;\n  txFee?: string | null;\n}\n```\n\n---\n\n## 📄 License\n\nMIT © Blsqui","readmeFilename":"README.md"}