@alien_org/contract 0.2.3 → 1.0.0-alpha

package/dist/index.cjs

@@ -15,7 +15,19 @@ const releases = {
 		"clipboard:write",
 		"clipboard:read"
 	],
-	"0.1.3": ["link:open"]
+	"0.1.3": ["link:open"],
+	"0.2.4": [
+		"haptic:impact",
+		"haptic:notification",
+		"haptic:selection"
+	],
+	"0.3.0": [
+		"wallet.solana:connect",
+		"wallet.solana:disconnect",
+		"wallet.solana:sign.transaction",
+		"wallet.solana:sign.message",
+		"wallet.solana:sign.send"
+	]
 };
 
 //#endregion
@@ -78,8 +90,32 @@ function getMethodMinVersion(method) {
 	}
 }
 
+//#endregion
+//#region src/utils.ts
+/**
+* Named constants for {@link WalletSolanaErrorCode}.
+*
+* @example
+* ```ts
+* import { WALLET_ERROR } from '@alien_org/contract';
+*
+* if (response.errorCode === WALLET_ERROR.USER_REJECTED) {
+*   // user cancelled
+* }
+* ```
+*
+* @since 0.3.0
+*/
+const WALLET_ERROR = {
+	USER_REJECTED: 5e3,
+	INVALID_PARAMS: -32602,
+	INTERNAL_ERROR: -32603,
+	REQUEST_EXPIRED: 8e3
+};
+
 //#endregion
 exports.PLATFORMS = PLATFORMS;
+exports.WALLET_ERROR = WALLET_ERROR;
 exports.getMethodMinVersion = getMethodMinVersion;
 exports.getReleaseVersion = getReleaseVersion;
 exports.isMethodSupported = isMethodSupported;

package/dist/index.d.cts

@@ -87,6 +87,77 @@ type PaymentWebhookStatus = 'finalized' | 'failed';
  * @schema
  */
 type PaymentTestScenario = 'paid' | 'paid:failed' | 'cancelled' | `error:${PaymentErrorCode}`;
+/**
+ * Haptic impact feedback styles.
+ * Maps to UIImpactFeedbackGenerator styles on iOS
+ * and VibrationEffect on Android.
+ * @since 0.2.4
+ * @schema
+ */
+type HapticImpactStyle = 'light' | 'medium' | 'heavy' | 'soft' | 'rigid';
+/**
+ * Haptic notification feedback types.
+ * Maps to UINotificationFeedbackGenerator types on iOS.
+ * @since 0.2.4
+ * @schema
+ */
+type HapticNotificationType = 'success' | 'warning' | 'error';
+/**
+ * Solana wallet error codes (WalletConnect-compatible numeric codes).
+ *
+ * These codes are identical to WalletConnect JSON-RPC error codes,
+ * so the mobile app produces the same `(code, message)` pair for
+ * both bridge and relay transports — no mapping needed.
+ *
+ * | Code | Meaning | WC Name |
+ * |------|---------|---------|
+ * | `5000` | User rejected the request | `userRejected` |
+ * | `-32602` | Invalid params (malformed transaction, bad input) | JSON-RPC standard |
+ * | `-32603` | Internal error (send failed, unexpected error) | JSON-RPC standard |
+ * | `8000` | Request expired / timed out | `sessionRequestExpired` |
+ *
+ * @since 0.3.0
+ * @schema
+ */
+type WalletSolanaErrorCode = 5000 | -32602 | -32603 | 8000;
+/**
+ * Named constants for {@link WalletSolanaErrorCode}.
+ *
+ * @example
+ * ```ts
+ * import { WALLET_ERROR } from '@alien_org/contract';
+ *
+ * if (response.errorCode === WALLET_ERROR.USER_REJECTED) {
+ *   // user cancelled
+ * }
+ * ```
+ *
+ * @since 0.3.0
+ */
+declare const WALLET_ERROR: {
+  /** User rejected the request (cancelled approval screen). */
+  readonly USER_REJECTED: 5000;
+  /** Invalid params — transaction deserialization failed, malformed input. */
+  readonly INVALID_PARAMS: -32602;
+  /** Internal error — transaction broadcast failed, unexpected error. */
+  readonly INTERNAL_ERROR: -32603;
+  /** Request expired before the user responded. */
+  readonly REQUEST_EXPIRED: 8000;
+};
+/**
+ * Solana commitment levels for send options.
+ * @since 0.3.0
+ * @schema
+ */
+type SolanaCommitment = 'processed' | 'confirmed' | 'finalized';
+/**
+ * Solana chain identifiers (wallet-standard format).
+ * Used by `wallet.solana:sign.send` to tell the host app
+ * which cluster to broadcast to.
+ * @since 0.3.0
+ * @schema
+ */
+type SolanaChain = 'solana:mainnet' | 'solana:devnet' | 'solana:testnet';
 //#endregion
 //#region src/events/types/payload.d.ts
 /**
@@ -180,6 +251,60 @@ interface Events {
      */
     errorCode?: 'permission_denied' | 'unavailable';
   }>>;
+  /**
+   * Solana wallet connection response.
+   * @since 0.3.0
+   * @schema
+   */
+  'wallet.solana:connect.response': CreateEventPayload<WithReqId<{
+    /** Base58-encoded public key of the connected wallet */
+    publicKey?: string;
+    /** Numeric error code (WalletConnect-compatible). See {@link WalletSolanaErrorCode}. */
+    errorCode?: WalletSolanaErrorCode;
+    /** Human-readable error description */
+    errorMessage?: string;
+  }>>;
+  /**
+   * Solana transaction signing response.
+   * @since 0.3.0
+   * @schema
+   */
+  'wallet.solana:sign.transaction.response': CreateEventPayload<WithReqId<{
+    /** Base64-encoded signed transaction */
+    signedTransaction?: string;
+    /** Numeric error code (WalletConnect-compatible). See {@link WalletSolanaErrorCode}. */
+    errorCode?: WalletSolanaErrorCode;
+    /** Human-readable error description */
+    errorMessage?: string;
+  }>>;
+  /**
+   * Solana message signing response.
+   * @since 0.3.0
+   * @schema
+   */
+  'wallet.solana:sign.message.response': CreateEventPayload<WithReqId<{
+    /** Base58-encoded Ed25519 signature (64 bytes) */
+    signature?: string;
+    /** Base58-encoded public key that signed the message */
+    publicKey?: string;
+    /** Numeric error code (WalletConnect-compatible). See {@link WalletSolanaErrorCode}. */
+    errorCode?: WalletSolanaErrorCode;
+    /** Human-readable error description */
+    errorMessage?: string;
+  }>>;
+  /**
+   * Solana sign-and-send transaction response.
+   * @since 0.3.0
+   * @schema
+   */
+  'wallet.solana:sign.send.response': CreateEventPayload<WithReqId<{
+    /** Base58-encoded transaction signature */
+    signature?: string;
+    /** Numeric error code (WalletConnect-compatible). See {@link WalletSolanaErrorCode}. */
+    errorCode?: WalletSolanaErrorCode;
+    /** Human-readable error description */
+    errorMessage?: string;
+  }>>;
 }
 //#endregion
 //#region src/events/types/event-types.d.ts
@@ -431,6 +556,108 @@ interface Methods {
      */
     openMode?: 'external' | 'internal';
   }>;
+  /**
+   * Trigger haptic impact feedback.
+   * Fire-and-forget — no response expected.
+   * @since 0.2.4
+   * @schema
+   */
+  'haptic:impact': CreateMethodPayload<{
+    /**
+     * The impact feedback style.
+     * @since 0.2.4
+     * @schema
+     */
+    style: HapticImpactStyle;
+  }>;
+  /**
+   * Trigger haptic notification feedback.
+   * Fire-and-forget — no response expected.
+   * @since 0.2.4
+   * @schema
+   */
+  'haptic:notification': CreateMethodPayload<{
+    /**
+     * The notification feedback type.
+     * @since 0.2.4
+     * @schema
+     */
+    type: HapticNotificationType;
+  }>;
+  /**
+   * Trigger haptic selection change feedback.
+   * Fire-and-forget — no response expected.
+   * @since 0.2.4
+   * @schema
+   */
+  'haptic:selection': CreateMethodPayload<Empty>;
+  /**
+   * Request Solana wallet connection.
+   * Returns the wallet's public key on success.
+   * @since 0.3.0
+   * @schema
+   */
+  'wallet.solana:connect': CreateMethodPayload<WithReqId<Empty>>;
+  /**
+   * Disconnect from Solana wallet.
+   * Fire-and-forget — no response expected.
+   * @since 0.3.0
+   * @schema
+   */
+  'wallet.solana:disconnect': CreateMethodPayload<Empty>;
+  /**
+   * Request Solana transaction signing.
+   * Returns the signed transaction bytes.
+   * @since 0.3.0
+   * @schema
+   */
+  'wallet.solana:sign.transaction': CreateMethodPayload<WithReqId<{
+    /** Base64-encoded serialized transaction (legacy or versioned) */
+    transaction: string;
+  }>>;
+  /**
+   * Request Solana message signing.
+   * Returns the Ed25519 signature.
+   * @since 0.3.0
+   * @schema
+   */
+  'wallet.solana:sign.message': CreateMethodPayload<WithReqId<{
+    /** Base58-encoded message bytes */
+    message: string;
+  }>>;
+  /**
+   * Request Solana transaction signing and sending.
+   * The host app signs and broadcasts the transaction.
+   * Returns the transaction signature.
+   * @since 0.3.0
+   * @schema
+   */
+  'wallet.solana:sign.send': CreateMethodPayload<WithReqId<{
+    /** Base64-encoded serialized transaction (legacy or versioned) */
+    transaction: string;
+    /**
+     * Target Solana cluster for broadcasting.
+     * In bridge mode the host app can infer this from miniapp config,
+     * but in relay mode (QR/WebSocket) this is required so the host
+     * app knows which RPC to broadcast to.
+     * @since 0.3.0
+     * @schema
+     */
+    chain?: SolanaChain;
+    /** Optional send options */
+    options?: {
+      skipPreflight?: boolean;
+      preflightCommitment?: SolanaCommitment;
+      /** Desired commitment level for transaction confirmation. */
+      commitment?: SolanaCommitment;
+      /**
+       * The minimum slot that the request can be evaluated at.
+       * Ensures the read is not served by a node lagging behind.
+       */
+      minContextSlot?: number;
+      maxRetries?: number;
+    };
+  }>>;
 }
 //#endregion
 //#region src/methods/types/method-types.d.ts
@@ -485,4 +712,4 @@ declare function isMethodSupported(method: MethodName, version: Version): boolea
  */
 declare function getMethodMinVersion(method: MethodName): Version | undefined;
 //#endregion
-export { type CreateEventPayload, type CreateMethodPayload, type EventName, type EventPayload, type Events, type LaunchParams, type MethodName, type MethodNameWithVersionedPayload, type MethodPayload, type MethodVersionedPayload, type Methods, PLATFORMS, type PaymentErrorCode, type PaymentTestScenario, type PaymentWebhookStatus, type Platform, type SafeAreaInsets, type Version, getMethodMinVersion, getReleaseVersion, isMethodSupported, releases };
+export { type CreateEventPayload, type CreateMethodPayload, type EventName, type EventPayload, type Events, type HapticImpactStyle, type HapticNotificationType, type LaunchParams, type MethodName, type MethodNameWithVersionedPayload, type MethodPayload, type MethodVersionedPayload, type Methods, PLATFORMS, type PaymentErrorCode, type PaymentTestScenario, type PaymentWebhookStatus, type Platform, type SafeAreaInsets, type SolanaChain, type SolanaCommitment, type Version, WALLET_ERROR, type WalletSolanaErrorCode, getMethodMinVersion, getReleaseVersion, isMethodSupported, releases };

package/dist/index.d.mts

@@ -87,6 +87,77 @@ type PaymentWebhookStatus = 'finalized' | 'failed';
  * @schema
  */
 type PaymentTestScenario = 'paid' | 'paid:failed' | 'cancelled' | `error:${PaymentErrorCode}`;
+/**
+ * Haptic impact feedback styles.
+ * Maps to UIImpactFeedbackGenerator styles on iOS
+ * and VibrationEffect on Android.
+ * @since 0.2.4
+ * @schema
+ */
+type HapticImpactStyle = 'light' | 'medium' | 'heavy' | 'soft' | 'rigid';
+/**
+ * Haptic notification feedback types.
+ * Maps to UINotificationFeedbackGenerator types on iOS.
+ * @since 0.2.4
+ * @schema
+ */
+type HapticNotificationType = 'success' | 'warning' | 'error';
+/**
+ * Solana wallet error codes (WalletConnect-compatible numeric codes).
+ *
+ * These codes are identical to WalletConnect JSON-RPC error codes,
+ * so the mobile app produces the same `(code, message)` pair for
+ * both bridge and relay transports — no mapping needed.
+ *
+ * | Code | Meaning | WC Name |
+ * |------|---------|---------|
+ * | `5000` | User rejected the request | `userRejected` |
+ * | `-32602` | Invalid params (malformed transaction, bad input) | JSON-RPC standard |
+ * | `-32603` | Internal error (send failed, unexpected error) | JSON-RPC standard |
+ * | `8000` | Request expired / timed out | `sessionRequestExpired` |
+ *
+ * @since 0.3.0
+ * @schema
+ */
+type WalletSolanaErrorCode = 5000 | -32602 | -32603 | 8000;
+/**
+ * Named constants for {@link WalletSolanaErrorCode}.
+ *
+ * @example
+ * ```ts
+ * import { WALLET_ERROR } from '@alien_org/contract';
+ *
+ * if (response.errorCode === WALLET_ERROR.USER_REJECTED) {
+ *   // user cancelled
+ * }
+ * ```
+ *
+ * @since 0.3.0
+ */
+declare const WALLET_ERROR: {
+  /** User rejected the request (cancelled approval screen). */
+  readonly USER_REJECTED: 5000;
+  /** Invalid params — transaction deserialization failed, malformed input. */
+  readonly INVALID_PARAMS: -32602;
+  /** Internal error — transaction broadcast failed, unexpected error. */
+  readonly INTERNAL_ERROR: -32603;
+  /** Request expired before the user responded. */
+  readonly REQUEST_EXPIRED: 8000;
+};
+/**
+ * Solana commitment levels for send options.
+ * @since 0.3.0
+ * @schema
+ */
+type SolanaCommitment = 'processed' | 'confirmed' | 'finalized';
+/**
+ * Solana chain identifiers (wallet-standard format).
+ * Used by `wallet.solana:sign.send` to tell the host app
+ * which cluster to broadcast to.
+ * @since 0.3.0
+ * @schema
+ */
+type SolanaChain = 'solana:mainnet' | 'solana:devnet' | 'solana:testnet';
 //#endregion
 //#region src/events/types/payload.d.ts
 /**
@@ -180,6 +251,60 @@ interface Events {
      */
     errorCode?: 'permission_denied' | 'unavailable';
   }>>;
+  /**
+   * Solana wallet connection response.
+   * @since 0.3.0
+   * @schema
+   */
+  'wallet.solana:connect.response': CreateEventPayload<WithReqId<{
+    /** Base58-encoded public key of the connected wallet */
+    publicKey?: string;
+    /** Numeric error code (WalletConnect-compatible). See {@link WalletSolanaErrorCode}. */
+    errorCode?: WalletSolanaErrorCode;
+    /** Human-readable error description */
+    errorMessage?: string;
+  }>>;
+  /**
+   * Solana transaction signing response.
+   * @since 0.3.0
+   * @schema
+   */
+  'wallet.solana:sign.transaction.response': CreateEventPayload<WithReqId<{
+    /** Base64-encoded signed transaction */
+    signedTransaction?: string;
+    /** Numeric error code (WalletConnect-compatible). See {@link WalletSolanaErrorCode}. */
+    errorCode?: WalletSolanaErrorCode;
+    /** Human-readable error description */
+    errorMessage?: string;
+  }>>;
+  /**
+   * Solana message signing response.
+   * @since 0.3.0
+   * @schema
+   */
+  'wallet.solana:sign.message.response': CreateEventPayload<WithReqId<{
+    /** Base58-encoded Ed25519 signature (64 bytes) */
+    signature?: string;
+    /** Base58-encoded public key that signed the message */
+    publicKey?: string;
+    /** Numeric error code (WalletConnect-compatible). See {@link WalletSolanaErrorCode}. */
+    errorCode?: WalletSolanaErrorCode;
+    /** Human-readable error description */
+    errorMessage?: string;
+  }>>;
+  /**
+   * Solana sign-and-send transaction response.
+   * @since 0.3.0
+   * @schema
+   */
+  'wallet.solana:sign.send.response': CreateEventPayload<WithReqId<{
+    /** Base58-encoded transaction signature */
+    signature?: string;
+    /** Numeric error code (WalletConnect-compatible). See {@link WalletSolanaErrorCode}. */
+    errorCode?: WalletSolanaErrorCode;
+    /** Human-readable error description */
+    errorMessage?: string;
+  }>>;
 }
 //#endregion
 //#region src/events/types/event-types.d.ts
@@ -431,6 +556,108 @@ interface Methods {
      */
     openMode?: 'external' | 'internal';
   }>;
+  /**
+   * Trigger haptic impact feedback.
+   * Fire-and-forget — no response expected.
+   * @since 0.2.4
+   * @schema
+   */
+  'haptic:impact': CreateMethodPayload<{
+    /**
+     * The impact feedback style.
+     * @since 0.2.4
+     * @schema
+     */
+    style: HapticImpactStyle;
+  }>;
+  /**
+   * Trigger haptic notification feedback.
+   * Fire-and-forget — no response expected.
+   * @since 0.2.4
+   * @schema
+   */
+  'haptic:notification': CreateMethodPayload<{
+    /**
+     * The notification feedback type.
+     * @since 0.2.4
+     * @schema
+     */
+    type: HapticNotificationType;
+  }>;
+  /**
+   * Trigger haptic selection change feedback.
+   * Fire-and-forget — no response expected.
+   * @since 0.2.4
+   * @schema
+   */
+  'haptic:selection': CreateMethodPayload<Empty>;
+  /**
+   * Request Solana wallet connection.
+   * Returns the wallet's public key on success.
+   * @since 0.3.0
+   * @schema
+   */
+  'wallet.solana:connect': CreateMethodPayload<WithReqId<Empty>>;
+  /**
+   * Disconnect from Solana wallet.
+   * Fire-and-forget — no response expected.
+   * @since 0.3.0
+   * @schema
+   */
+  'wallet.solana:disconnect': CreateMethodPayload<Empty>;
+  /**
+   * Request Solana transaction signing.
+   * Returns the signed transaction bytes.
+   * @since 0.3.0
+   * @schema
+   */
+  'wallet.solana:sign.transaction': CreateMethodPayload<WithReqId<{
+    /** Base64-encoded serialized transaction (legacy or versioned) */
+    transaction: string;
+  }>>;
+  /**
+   * Request Solana message signing.
+   * Returns the Ed25519 signature.
+   * @since 0.3.0
+   * @schema
+   */
+  'wallet.solana:sign.message': CreateMethodPayload<WithReqId<{
+    /** Base58-encoded message bytes */
+    message: string;
+  }>>;
+  /**
+   * Request Solana transaction signing and sending.
+   * The host app signs and broadcasts the transaction.
+   * Returns the transaction signature.
+   * @since 0.3.0
+   * @schema
+   */
+  'wallet.solana:sign.send': CreateMethodPayload<WithReqId<{
+    /** Base64-encoded serialized transaction (legacy or versioned) */
+    transaction: string;
+    /**
+     * Target Solana cluster for broadcasting.
+     * In bridge mode the host app can infer this from miniapp config,
+     * but in relay mode (QR/WebSocket) this is required so the host
+     * app knows which RPC to broadcast to.
+     * @since 0.3.0
+     * @schema
+     */
+    chain?: SolanaChain;
+    /** Optional send options */
+    options?: {
+      skipPreflight?: boolean;
+      preflightCommitment?: SolanaCommitment;
+      /** Desired commitment level for transaction confirmation. */
+      commitment?: SolanaCommitment;
+      /**
+       * The minimum slot that the request can be evaluated at.
+       * Ensures the read is not served by a node lagging behind.
+       */
+      minContextSlot?: number;
+      maxRetries?: number;
+    };
+  }>>;
 }
 //#endregion
 //#region src/methods/types/method-types.d.ts
@@ -485,4 +712,4 @@ declare function isMethodSupported(method: MethodName, version: Version): boolea
  */
 declare function getMethodMinVersion(method: MethodName): Version | undefined;
 //#endregion
-export { type CreateEventPayload, type CreateMethodPayload, type EventName, type EventPayload, type Events, type LaunchParams, type MethodName, type MethodNameWithVersionedPayload, type MethodPayload, type MethodVersionedPayload, type Methods, PLATFORMS, type PaymentErrorCode, type PaymentTestScenario, type PaymentWebhookStatus, type Platform, type SafeAreaInsets, type Version, getMethodMinVersion, getReleaseVersion, isMethodSupported, releases };
+export { type CreateEventPayload, type CreateMethodPayload, type EventName, type EventPayload, type Events, type HapticImpactStyle, type HapticNotificationType, type LaunchParams, type MethodName, type MethodNameWithVersionedPayload, type MethodPayload, type MethodVersionedPayload, type Methods, PLATFORMS, type PaymentErrorCode, type PaymentTestScenario, type PaymentWebhookStatus, type Platform, type SafeAreaInsets, type SolanaChain, type SolanaCommitment, type Version, WALLET_ERROR, type WalletSolanaErrorCode, getMethodMinVersion, getReleaseVersion, isMethodSupported, releases };

package/dist/index.mjs

@@ -14,7 +14,19 @@ const releases = {
 		"clipboard:write",
 		"clipboard:read"
 	],
-	"0.1.3": ["link:open"]
+	"0.1.3": ["link:open"],
+	"0.2.4": [
+		"haptic:impact",
+		"haptic:notification",
+		"haptic:selection"
+	],
+	"0.3.0": [
+		"wallet.solana:connect",
+		"wallet.solana:disconnect",
+		"wallet.solana:sign.transaction",
+		"wallet.solana:sign.message",
+		"wallet.solana:sign.send"
+	]
 };
 
 //#endregion
@@ -78,4 +90,27 @@ function getMethodMinVersion(method) {
 }
 
 //#endregion
-export { PLATFORMS, getMethodMinVersion, getReleaseVersion, isMethodSupported, releases };
+//#region src/utils.ts
+/**
+* Named constants for {@link WalletSolanaErrorCode}.
+*
+* @example
+* ```ts
+* import { WALLET_ERROR } from '@alien_org/contract';
+*
+* if (response.errorCode === WALLET_ERROR.USER_REJECTED) {
+*   // user cancelled
+* }
+* ```
+*
+* @since 0.3.0
+*/
+const WALLET_ERROR = {
+	USER_REJECTED: 5e3,
+	INVALID_PARAMS: -32602,
+	INTERNAL_ERROR: -32603,
+	REQUEST_EXPIRED: 8e3
+};
+
+//#endregion
+export { PLATFORMS, WALLET_ERROR, getMethodMinVersion, getReleaseVersion, isMethodSupported, releases };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alien_org/contract",
-  "version": "0.2.3",
+  "version": "1.0.0-alpha",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",