@buildonspark/spark-sdk 0.5.0 → 0.5.1

package/src/proto/spark_authn.ts

@@ -1,6 +1,6 @@
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.7.7
+//   protoc-gen-ts_proto  v2.8.3
 //   protoc               v5.29.3
 // source: spark_authn.proto
 

package/src/proto/spark_token.ts

@@ -1,6 +1,6 @@
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.7.7
+//   protoc-gen-ts_proto  v2.8.3
 //   protoc               v5.29.3
 // source: spark_token.proto
 
@@ -197,7 +197,11 @@ export interface TokenCreateInput {
   /** Decoded uint128 */
   maxSupply: Uint8Array;
   isFreezable: boolean;
-  creationEntityPublicKey?: Uint8Array | undefined;
+  creationEntityPublicKey?:
+    | Uint8Array
+    | undefined;
+  /** If any of the fields below are provided, use protohash to generate the token_identifier */
+  extraMetadata?: Uint8Array | undefined;
 }
 
 /**
@@ -422,6 +426,7 @@ export interface TokenMetadata {
   isFreezable: boolean;
   creationEntityPublicKey?: Uint8Array | undefined;
   tokenIdentifier: Uint8Array;
+  extraMetadata?: Uint8Array | undefined;
 }
 
 export interface QueryTokenMetadataResponse {
@@ -748,6 +753,7 @@ function createBaseTokenCreateInput(): TokenCreateInput {
     maxSupply: new Uint8Array(0),
     isFreezable: false,
     creationEntityPublicKey: undefined,
+    extraMetadata: undefined,
   };
 }
 
@@ -774,6 +780,9 @@ export const TokenCreateInput: MessageFns<TokenCreateInput> = {
     if (message.creationEntityPublicKey !== undefined) {
       writer.uint32(58).bytes(message.creationEntityPublicKey);
     }
+    if (message.extraMetadata !== undefined) {
+      writer.uint32(66).bytes(message.extraMetadata);
+    }
     return writer;
   },
 
@@ -840,6 +849,14 @@ export const TokenCreateInput: MessageFns<TokenCreateInput> = {
           message.creationEntityPublicKey = reader.bytes();
           continue;
         }
+        case 8: {
+          if (tag !== 66) {
+            break;
+          }
+
+          message.extraMetadata = reader.bytes();
+          continue;
+        }
       }
       if ((tag & 7) === 4 || tag === 0) {
         break;
@@ -860,6 +877,7 @@ export const TokenCreateInput: MessageFns<TokenCreateInput> = {
       creationEntityPublicKey: isSet(object.creationEntityPublicKey)
         ? bytesFromBase64(object.creationEntityPublicKey)
         : undefined,
+      extraMetadata: isSet(object.extraMetadata) ? bytesFromBase64(object.extraMetadata) : undefined,
     };
   },
 
@@ -886,6 +904,9 @@ export const TokenCreateInput: MessageFns<TokenCreateInput> = {
     if (message.creationEntityPublicKey !== undefined) {
       obj.creationEntityPublicKey = base64FromBytes(message.creationEntityPublicKey);
     }
+    if (message.extraMetadata !== undefined) {
+      obj.extraMetadata = base64FromBytes(message.extraMetadata);
+    }
     return obj;
   },
 
@@ -901,6 +922,7 @@ export const TokenCreateInput: MessageFns<TokenCreateInput> = {
     message.maxSupply = object.maxSupply ?? new Uint8Array(0);
     message.isFreezable = object.isFreezable ?? false;
     message.creationEntityPublicKey = object.creationEntityPublicKey ?? undefined;
+    message.extraMetadata = object.extraMetadata ?? undefined;
     return message;
   },
 };
@@ -3081,6 +3103,7 @@ function createBaseTokenMetadata(): TokenMetadata {
     isFreezable: false,
     creationEntityPublicKey: undefined,
     tokenIdentifier: new Uint8Array(0),
+    extraMetadata: undefined,
   };
 }
 
@@ -3110,6 +3133,9 @@ export const TokenMetadata: MessageFns<TokenMetadata> = {
     if (message.tokenIdentifier.length !== 0) {
       writer.uint32(66).bytes(message.tokenIdentifier);
     }
+    if (message.extraMetadata !== undefined) {
+      writer.uint32(74).bytes(message.extraMetadata);
+    }
     return writer;
   },
 
@@ -3184,6 +3210,14 @@ export const TokenMetadata: MessageFns<TokenMetadata> = {
           message.tokenIdentifier = reader.bytes();
           continue;
         }
+        case 9: {
+          if (tag !== 74) {
+            break;
+          }
+
+          message.extraMetadata = reader.bytes();
+          continue;
+        }
       }
       if ((tag & 7) === 4 || tag === 0) {
         break;
@@ -3205,6 +3239,7 @@ export const TokenMetadata: MessageFns<TokenMetadata> = {
         ? bytesFromBase64(object.creationEntityPublicKey)
         : undefined,
       tokenIdentifier: isSet(object.tokenIdentifier) ? bytesFromBase64(object.tokenIdentifier) : new Uint8Array(0),
+      extraMetadata: isSet(object.extraMetadata) ? bytesFromBase64(object.extraMetadata) : undefined,
     };
   },
 
@@ -3234,6 +3269,9 @@ export const TokenMetadata: MessageFns<TokenMetadata> = {
     if (message.tokenIdentifier.length !== 0) {
       obj.tokenIdentifier = base64FromBytes(message.tokenIdentifier);
     }
+    if (message.extraMetadata !== undefined) {
+      obj.extraMetadata = base64FromBytes(message.extraMetadata);
+    }
     return obj;
   },
 
@@ -3250,6 +3288,7 @@ export const TokenMetadata: MessageFns<TokenMetadata> = {
     message.isFreezable = object.isFreezable ?? false;
     message.creationEntityPublicKey = object.creationEntityPublicKey ?? undefined;
     message.tokenIdentifier = object.tokenIdentifier ?? new Uint8Array(0);
+    message.extraMetadata = object.extraMetadata ?? undefined;
     return message;
   },
 };

package/src/proto/validate/validate.ts

@@ -1,6 +1,6 @@
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.7.7
+//   protoc-gen-ts_proto  v2.8.3
 //   protoc               v5.29.3
 // source: validate/validate.proto
 

package/src/services/connection/connection.ts

@@ -215,6 +215,10 @@ export abstract class ConnectionManager {
     return serverTime;
   }
 
+  public isTimeSynced(): boolean {
+    return this.timeSync.isSynced();
+  }
+
   protected getMonotonicTime(): number {
     return getMonotonicTime();
   }
@@ -438,54 +442,6 @@ export abstract class ConnectionManager {
     return metadata;
   }
 
-  protected recordTimeSync(
-    dateHeader: string,
-    serverProcessingTimeMs: number,
-    sendTime: number,
-    receiveTime: number,
-  ) {
-    this.timeSync.recordSync(
-      dateHeader,
-      serverProcessingTimeMs,
-      sendTime,
-      receiveTime,
-    );
-  }
-
-  private processResponseForTimeSync(
-    result: IteratorResult<any, any>,
-    firstResponse: boolean,
-    sendTime: number,
-  ): boolean {
-    if (!firstResponse) return false;
-
-    const receiveTime = this.getMonotonicTime();
-
-    if (typeof result.value === "object" && result.value !== null) {
-      const responseObj = result.value as any;
-      if (responseObj.header && responseObj.header instanceof Metadata) {
-        const dateHeader = responseObj.header.get(
-          ConnectionManager.DATE_HEADER,
-        )?.[0];
-        const processingTimeHeader = responseObj.header.get(
-          ConnectionManager.PROCESSING_TIME_HEADER,
-        )?.[0];
-
-        if (dateHeader && processingTimeHeader) {
-          const serverProcessingTimeMs = parseFloat(processingTimeHeader);
-          this.recordTimeSync(
-            dateHeader,
-            serverProcessingTimeMs,
-            sendTime,
-            receiveTime,
-          );
-        }
-      }
-    }
-
-    return true;
-  }
-
   protected createAuthnMiddleware() {
     return async function* <Req, Res>(
       this: ConnectionManager,
@@ -512,33 +468,40 @@ export abstract class ConnectionManager {
       const metadata = this.prepareMetadata(Metadata(options.metadata));
       const authToken = await this.authenticate(address);
       const sendTime = this.getMonotonicTime();
+      const receiveTime = { value: 0 };
 
       try {
         const generator = call.next(call.request as Req, {
           ...options,
           metadata: metadata.set("Authorization", `Bearer ${authToken}`),
+          onHeader: (header: Metadata) => {
+            receiveTime.value = this.getMonotonicTime();
+
+            const dateHeader = header.get(ConnectionManager.DATE_HEADER);
+            const processingTimeHeader = header.get(
+              ConnectionManager.PROCESSING_TIME_HEADER,
+            );
+
+            if (dateHeader && processingTimeHeader) {
+              const serverProcessingTimeMs = parseFloat(processingTimeHeader);
+              this.timeSync.recordSync(
+                dateHeader,
+                serverProcessingTimeMs,
+                sendTime,
+                receiveTime.value,
+              );
+            }
+          },
         });
 
-        let firstResponse = true;
         let result = await generator.next();
 
         while (!result.done) {
-          if (firstResponse) {
-            firstResponse = this.processResponseForTimeSync(
-              result,
-              firstResponse,
-              sendTime,
-            );
-          }
-
           yield result.value;
           result = await generator.next();
         }
 
         if (result.value !== undefined) {
-          if (firstResponse) {
-            this.processResponseForTimeSync(result, firstResponse, sendTime);
-          }
           return result.value;
         }
       } catch (error: unknown) {

package/src/services/coop-exit.ts

@@ -173,9 +173,7 @@ export class CoopExitService extends BaseTransferService {
       const signingJob: LeafRefundTxSigningJob = {
         leafId: leaf.leaf.id,
         refundTxSigningJob: {
-          signingPublicKey: await this.config.signer.getPublicKeyFromDerivation(
-            leaf.keyDerivation,
-          ),
+          signingPublicKey,
           rawTx: cpfpRefundTx.toBytes(),
           signingNonceCommitment: signingNonceCommitment.commitment,
         },
@@ -242,14 +240,14 @@ export class CoopExitService extends BaseTransferService {
       });
     } catch (error) {
       throw new SparkRequestError("Failed to initiate cooperative exit", {
-        operation: "cooperative_exit",
+        operation: "cooperative_exit_v2",
         error,
       });
     }
 
     if (!response.transfer) {
       throw new SparkRequestError("Failed to initiate cooperative exit", {
-        operation: "cooperative_exit",
+        operation: "cooperative_exit_v2",
         error: new Error("No transfer in response"),
       });
     }

package/src/services/deposit.ts

@@ -599,7 +599,7 @@ export class DepositService {
       });
     } catch (error) {
       throw new SparkRequestError("Failed to finalize node signatures", {
-        operation: "finalize_node_signatures",
+        operation: "finalize_node_signatures_v2",
         error,
       });
     }

package/src/services/lightning.ts

@@ -310,7 +310,7 @@ export class LightningService {
       });
     } catch (error) {
       throw new SparkRequestError("Failed to initiate preimage swap", {
-        operation: "initiate_preimage_swap",
+        operation: "initiate_preimage_swap_v3",
         error,
       });
     }

package/src/services/signing.ts

@@ -49,12 +49,13 @@ export class SigningService {
         expected: "Non-null signing commitments",
       });
     }
+    const publicKey = await this.config.signer.getPublicKeyFromDerivation(
+      leaf.keyDerivation,
+    );
     const signingResult = await this.config.signer.signFrost({
       message: sighash,
       keyDerivation: leaf.keyDerivation,
-      publicKey: await this.config.signer.getPublicKeyFromDerivation(
-        leaf.keyDerivation,
-      ),
+      publicKey,
       selfCommitment: signingCommitment,
       statechainCommitments: signingCommitments,
       adaptorPubKey: new Uint8Array(),
@@ -63,9 +64,7 @@ export class SigningService {
 
     leafSigningJobs.push({
       leafId: leaf.leaf.id,
-      signingPublicKey: await this.config.signer.getPublicKeyFromDerivation(
-        leaf.keyDerivation,
-      ),
+      signingPublicKey: publicKey,
       rawTx: refundTx.toBytes(),
       signingNonceCommitment: signingCommitment.commitment,
       userSignature: signingResult,