@three-ws/x402-modal 0.2.0 → 0.2.1

package/src/x402-modal.js

@@ -40,10 +40,10 @@ import {
 const VERSION = '0.2.0';
 
 // ─────────────────────────────────────────────────────────── configuration ───
-// Everything the host wants to brand or repoint lives here. Defaults reproduce
-// three.ws's hosted behaviour exactly, so the drop-in script is unchanged; a
-// standalone deployment overrides them with `configure()` (global) or per-call
-// `pay({ ... })` options (which always win over the global config).
+// Everything the host wants to brand or repoint lives here. The defaults are
+// vendor-neutral: no footer attribution and no builder-code echo until the host
+// opts in. A deployment supplies its own branding with `configure()` (global)
+// or per-call `pay({ ... })` options (which always win over the global config).
 
 const DEFAULTS = {
 	// Origin that serves the Solana `prepare` / `encode` checkout helpers
@@ -51,12 +51,13 @@ const DEFAULTS = {
 	// payment path uses these — the EVM/EIP-3009 path is fully client-side and
 	// needs no backend. `null` ⇒ resolve from the script's own origin at runtime.
 	apiOrigin: null,
-	// Footer attribution shown at the bottom of the modal.
-	brand: { label: 'Powered by three.ws', href: 'https://three.ws' },
+	// Footer attribution shown at the bottom of the modal. `null` ⇒ the footer
+	// link is hidden until a host sets `{ label, href? }`.
+	brand: null,
 	// ERC-8021 builder-code self-attribution echoed back when the 402 challenge
 	// declares a builder code. `wallet` = your wallet code, `service` = your
-	// integration code. Set to null to disable the echo entirely.
-	builderCode: { wallet: '3d_agent', service: '3d_agent_modal' },
+	// integration code. `null` ⇒ no self-attribution unless a host opts in.
+	builderCode: null,
 	// CDN modules dynamic-imported on demand. Override to self-host / satisfy a
 	// strict Content-Security-Policy.
 	solanaWeb3Url: 'https://esm.sh/@solana/web3.js@1.95.3?bundle',
@@ -65,7 +66,7 @@ const DEFAULTS = {
 
 const config = {
 	apiOrigin: DEFAULTS.apiOrigin,
-	brand: { ...DEFAULTS.brand },
+	brand: DEFAULTS.brand ? { ...DEFAULTS.brand } : null,
 	builderCode: DEFAULTS.builderCode ? { ...DEFAULTS.builderCode } : null,
 	solanaWeb3Url: DEFAULTS.solanaWeb3Url,
 	nobleHashesUrl: DEFAULTS.nobleHashesUrl,
@@ -90,7 +91,8 @@ function resolveScriptOrigin() {
 export function configure(opts = {}) {
 	if (!opts || typeof opts !== 'object') return getConfig();
 	if (opts.apiOrigin !== undefined) config.apiOrigin = opts.apiOrigin;
-	if (opts.brand) config.brand = { ...config.brand, ...opts.brand };
+	if (opts.brand === null) config.brand = null;
+	else if (opts.brand) config.brand = { ...(config.brand || {}), ...opts.brand };
 	if (opts.builderCode === null) config.builderCode = null;
 	else if (opts.builderCode) config.builderCode = { ...(config.builderCode || {}), ...opts.builderCode };
 	if (opts.solanaWeb3Url) config.solanaWeb3Url = opts.solanaWeb3Url;
@@ -101,7 +103,7 @@ export function configure(opts = {}) {
 export function getConfig() {
 	return {
 		apiOrigin: config.apiOrigin,
-		brand: { ...config.brand },
+		brand: config.brand ? { ...config.brand } : null,
 		builderCode: config.builderCode ? { ...config.builderCode } : null,
 		solanaWeb3Url: config.solanaWeb3Url,
 		nobleHashesUrl: config.nobleHashesUrl,
@@ -840,12 +842,15 @@ export class CheckoutModal {
 			this.siwx = extractSiwxExtension(challenge);
 			this.payFlowOverride = false;
 			this.siwxFallbackNotice = null;
-			// Prefer Solana when Phantom is present, else first EIP-3009 EVM entry
-			// (skipping Permit2 siblings the modal can't sign for), else first accept.
+			// Solana-first platform default: select the Solana accept by default
+			// whenever one is offered, regardless of which wallet is detected —
+			// renderConnect() still shows both wallet buttons (Solana listed
+			// first), so EVM users simply click the EVM option. Falls back to the
+			// first EIP-3009 EVM entry (skipping Permit2 siblings the modal can't
+			// sign for), then the first accept.
 			const solana = challenge.accepts.find((a) => isSolanaNetwork(a.network));
 			const evm = challenge.accepts.find(isEip3009Accept);
-			const phantomDetected = typeof window !== 'undefined' && (window.solana?.isPhantom || window.phantom?.solana);
-			this.accept = (phantomDetected && solana) || evm || challenge.accepts[0];
+			this.accept = solana || evm || challenge.accepts[0];
 			this.setPrice(this.accept);
 			this.renderConnect();
 		} catch (err) {

package/types/index.d.ts

@@ -32,7 +32,10 @@ export interface SpendingCaps {
 	maxPerDay?: number | string;
 }
 
-/** Global configuration. Defaults reproduce three.ws's hosted behaviour. */
+/**
+ * Global configuration. Defaults are vendor-neutral: `brand` and `builderCode`
+ * are `null` until a host opts in.
+ */
 export interface X402Config {
 	/**
 	 * Origin serving the Solana `prepare`/`encode` checkout helpers
@@ -41,8 +44,9 @@ export interface X402Config {
 	 * resolves from the script's own origin. `''` means same-origin.
 	 */
 	apiOrigin?: string | null;
-	brand?: Brand;
-	/** `null` disables the builder-code echo entirely. */
+	/** `null` hides the footer attribution entirely (the default). */
+	brand?: Brand | null;
+	/** `null` disables the builder-code echo entirely (the default). */
 	builderCode?: BuilderCode | null;
 	/** CDN URL for `@solana/web3.js`, dynamic-imported on the Solana path. */
 	solanaWeb3Url?: string;