@kynesyslabs/demosdk 2.12.2 → 4.0.0

package/build/denomination/serializerGate.test.js

@@ -0,0 +1,255 @@
+import { describe, test, expect } from "@jest/globals";
+import { serializeTransactionContent } from "./serializerGate.js";
+// REVIEW: P4 commit 2 — load-bearing wire boundary. Tests assert byte
+// identity for the pre-fork branch (must equal legacy `JSON.stringify`)
+// and the canonical post-fork shape (`amount`, `transaction_fee.*`, and
+// targeted `gcr_edits[].amount` carriers as OS strings; key order
+// preserved).
+/**
+ * Build a `TransactionContent` fixture in the canonical key order, with
+ * a mix of `gcr_edits` entries to exercise the per-variant transformer.
+ */
+function buildFixture() {
+    const gcr_edits = [
+        {
+            type: "balance",
+            isRollback: false,
+            operation: "remove",
+            account: "0xsender",
+            amount: 100, // legacy DEM number
+            txhash: "",
+        },
+        {
+            type: "nonce",
+            isRollback: false,
+            operation: "add",
+            account: "0xsender",
+            amount: 1,
+            txhash: "",
+        },
+        {
+            type: "balance",
+            isRollback: false,
+            operation: "add",
+            account: "0xreceiver",
+            amount: 100,
+            txhash: "",
+        },
+        {
+            type: "escrow",
+            operation: "deposit",
+            account: "0xescrow",
+            data: {
+                sender: "0xsender",
+                platform: "twitter",
+                username: "@bob",
+                amount: 100, // legacy DEM number — should become OS string post-fork
+                expiryDays: 30,
+            },
+            txhash: "",
+            isRollback: false,
+        },
+    ];
+    const content = {
+        type: "native",
+        from: "0xsender",
+        to: "0xreceiver",
+        amount: 100, // legacy DEM
+        data: [
+            "native",
+            {
+                nativeOperation: "send",
+                args: ["0xreceiver", 100],
+            },
+        ],
+        nonce: 1,
+        timestamp: 1700000000000,
+        transaction_fee: {
+            network_fee: 1,
+            rpc_fee: 0,
+            additional_fee: 0,
+            rpc_address: null,
+        },
+        from_ed25519_address: "0xsender",
+        gcr_edits,
+    };
+    return content;
+}
+describe("serializerGate — pre-fork branch", () => {
+    test("output is byte-identical to legacy JSON.stringify for current SDK content", () => {
+        const content = buildFixture();
+        const expected = JSON.stringify(content);
+        expect(serializeTransactionContent(content, false)).toBe(expected);
+    });
+    test("normalises stray bigint amount back to legacy DEM number", () => {
+        const content = buildFixture();
+        // Simulate an internal bigint OS amount leaking into content.
+        // 100 DEM = 100_000_000_000n OS.
+        content.amount = 100000000000n;
+        const out = serializeTransactionContent(content, false);
+        const parsed = JSON.parse(out);
+        expect(parsed.amount).toBe(100);
+    });
+    test("normalises stray OS-string amount back to DEM number", () => {
+        const content = buildFixture();
+        content.amount = "100000000000";
+        const out = serializeTransactionContent(content, false);
+        const parsed = JSON.parse(out);
+        expect(parsed.amount).toBe(100);
+    });
+    test("normalises bigint balance edit back to DEM number", () => {
+        const content = buildFixture();
+        content.gcr_edits[0].amount = 100000000000n;
+        const out = serializeTransactionContent(content, false);
+        const parsed = JSON.parse(out);
+        expect(parsed.gcr_edits[0].amount).toBe(100);
+    });
+});
+describe("serializerGate — post-fork branch", () => {
+    test("amount becomes OS string", () => {
+        const content = buildFixture();
+        const out = serializeTransactionContent(content, true);
+        const parsed = JSON.parse(out);
+        expect(parsed.amount).toBe("100000000000");
+    });
+    test("transaction_fee fields all become OS strings", () => {
+        const content = buildFixture();
+        const out = serializeTransactionContent(content, true);
+        const parsed = JSON.parse(out);
+        expect(parsed.transaction_fee.network_fee).toBe("1000000000");
+        expect(parsed.transaction_fee.rpc_fee).toBe("0");
+        expect(parsed.transaction_fee.additional_fee).toBe("0");
+    });
+    test("gcr_edits balance amounts become OS strings; nonce stays a number", () => {
+        const content = buildFixture();
+        const out = serializeTransactionContent(content, true);
+        const parsed = JSON.parse(out);
+        expect(parsed.gcr_edits[0].amount).toBe("100000000000");
+        expect(parsed.gcr_edits[1].amount).toBe(1); // nonce — counter, untouched
+        expect(parsed.gcr_edits[2].amount).toBe("100000000000");
+    });
+    test("escrow nested amount becomes OS string", () => {
+        const content = buildFixture();
+        const out = serializeTransactionContent(content, true);
+        const parsed = JSON.parse(out);
+        expect(parsed.gcr_edits[3].data.amount).toBe("100000000000");
+    });
+    test("post-fork output preserves canonical top-level key order", () => {
+        const content = buildFixture();
+        const out = serializeTransactionContent(content, true);
+        const parsed = JSON.parse(out);
+        // Canonical order from SPEC_P4 §3.5.
+        expect(Object.keys(parsed)).toEqual([
+            "type",
+            "from",
+            "to",
+            "amount",
+            "data",
+            "nonce",
+            "timestamp",
+            "transaction_fee",
+            "from_ed25519_address",
+            "gcr_edits",
+        ]);
+    });
+    test("post-fork output preserves transaction_fee key order", () => {
+        const content = buildFixture();
+        const out = serializeTransactionContent(content, true);
+        const parsed = JSON.parse(out);
+        // DEM-665: rpc_address is now part of the canonical TxFee shape;
+        // buildFixture writes it after additional_fee.
+        expect(Object.keys(parsed.transaction_fee)).toEqual([
+            "network_fee",
+            "rpc_fee",
+            "additional_fee",
+            "rpc_address",
+        ]);
+    });
+    test("non-canonical OS string is normalised", () => {
+        const content = buildFixture();
+        // "00100" must become "100" after re-emit.
+        content.amount = "00100";
+        const out = serializeTransactionContent(content, true);
+        const parsed = JSON.parse(out);
+        expect(parsed.amount).toBe("100");
+    });
+    test("bigint amount round-trips through the wire", () => {
+        const content = buildFixture();
+        content.amount = 1500000000n;
+        const out = serializeTransactionContent(content, true);
+        const parsed = JSON.parse(out);
+        expect(parsed.amount).toBe("1500000000");
+    });
+    test("sub-DEM precision preserved via OS string", () => {
+        const content = buildFixture();
+        // 0.000000001 DEM = 1n OS.
+        content.amount = 1n;
+        const out = serializeTransactionContent(content, true);
+        const parsed = JSON.parse(out);
+        expect(parsed.amount).toBe("1");
+    });
+});
+describe("serializerGate — input invariance", () => {
+    test("does not mutate the input content object", () => {
+        const content = buildFixture();
+        const before = JSON.stringify(content);
+        serializeTransactionContent(content, true);
+        expect(JSON.stringify(content)).toBe(before);
+    });
+});
+describe("serializerGate — transaction_fee key order (myc#19)", () => {
+    test("post-fork preserves non-canonical fee insertion order", () => {
+        const content = buildFixture();
+        // Construct fee with `additional_fee` first to break the old
+        // hard-coded literal order. DEM-665: rpc_address joins the
+        // ordered key set and must round-trip in its declared position.
+        content.transaction_fee = {
+            additional_fee: 0,
+            rpc_address: null,
+            rpc_fee: 0,
+            network_fee: 1,
+        };
+        const out = serializeTransactionContent(content, true);
+        const parsed = JSON.parse(out);
+        expect(Object.keys(parsed.transaction_fee)).toEqual([
+            "additional_fee",
+            "rpc_address",
+            "rpc_fee",
+            "network_fee",
+        ]);
+    });
+    test("pre-fork preserves non-canonical fee insertion order", () => {
+        const content = buildFixture();
+        content.transaction_fee = {
+            additional_fee: 0,
+            rpc_address: null,
+            rpc_fee: 0,
+            network_fee: 1,
+        };
+        const out = serializeTransactionContent(content, false);
+        const parsed = JSON.parse(out);
+        expect(Object.keys(parsed.transaction_fee)).toEqual([
+            "additional_fee",
+            "rpc_address",
+            "rpc_fee",
+            "network_fee",
+        ]);
+    });
+    test("post-fork passes through unknown extra fee fields verbatim", () => {
+        const content = buildFixture();
+        content.transaction_fee = {
+            network_fee: 1,
+            rpc_fee: 0,
+            additional_fee: 0,
+            rpc_address: null,
+            // Future extension field the SDK doesn't know about — must
+            // not be dropped (consensus would diverge if the node knows
+            // it and we strip it).
+            future_field: "abc",
+        };
+        const out = serializeTransactionContent(content, true);
+        const parsed = JSON.parse(out);
+        expect(parsed.transaction_fee.future_field).toBe("abc");
+    });
+});
+//# sourceMappingURL=serializerGate.test.js.map

package/build/denomination/serializerGate.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializerGate.test.js","sourceRoot":"","sources":["../../../src/denomination/serializerGate.test.ts"],"names":[],"mappings":"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"}

package/build/escrow/EscrowTransaction.d.ts

@@ -15,31 +15,62 @@ export declare class EscrowTransaction {
      */
     static getEscrowAddress(platform: string, username: string): string;
     /**
-     * Creates a transaction to send DEM to a social identity escrow
+     * Creates a transaction to send DEM to a social identity escrow.
+     *
+     * P4 dual-input:
+     *  - `bigint` (preferred, post-v3): OS amount.
+     *  - `number` (deprecated, v2 callers): DEM amount, auto-converted.
+     *
+     * Internal carrier in `tx.content.amount` and `gcr_edits[].amount`
+     * is bigint OS; the serializerGate (called from `demos.sign`)
+     * picks the wire shape per fork status. Sub-DEM precision against
+     * a pre-fork node throws `SubDemPrecisionError`.
      *
      * @example
      * ```typescript
+     * import { denomination } from "@kynesyslabs/demosdk"
      * const tx = await EscrowTransaction.sendToIdentity(
      *   demos,
      *   "twitter",
      *   "@bob",
-     *   100,
+     *   denomination.demToOs(100),  // 100 DEM
      *   { expiryDays: 30, message: "Welcome to Demos!" }
      * )
-     * await demos.submitTransaction(tx)
+     * await demos.confirm(tx)
      * ```
      *
      * @param demos - Demos SDK instance (must have keypair set)
      * @param platform - Social platform ("twitter", "github", "telegram")
      * @param username - Username on that platform
-     * @param amount - Amount of DEM to send (number)
+     * @param amount - DEM `number` (legacy) or OS `bigint` (preferred).
      * @param options - Optional parameters
      * @returns Signed transaction ready to submit
      */
-    static sendToIdentity(demos: Demos, platform: "twitter" | "github" | "telegram", username: string, amount: number, options?: {
+    static sendToIdentity(demos: Demos, platform: "twitter" | "github" | "telegram", username: string, amount: number | bigint, options?: {
         expiryDays?: number;
         message?: string;
     }): Promise<Transaction>;
+    /**
+     * Normalise a public-API amount input (`number` legacy DEM or
+     * `bigint` OS) into both forms. Used at every boundary that needs
+     * dual-shape support during the pre-/post-fork rollout.
+     *
+     * - `number` input: must be a non-negative integer DEM amount;
+     *   converted to OS via `OS_PER_DEM`. Fractional DEM `number` is
+     *   rejected — silently flooring (the previous behaviour) discarded
+     *   up to ~10^9 OS per call. Callers who need sub-DEM precision
+     *   must pass a `bigint` OS amount (e.g. `denomination.demToOs("1.5")`).
+     * - `bigint` input: treated as OS; DEM form is the integer division
+     *   `amountOs / OS_PER_DEM`. The pre-fork sub-DEM precision rejection
+     *   lives in `Demos._assertAmountAcceptableOnTargetNode` (called by
+     *   `sendToIdentity` before this helper runs).
+     *
+     * @internal Exposed only to keep the migration paths discoverable.
+     */
+    static normalizeAmountInput(amount: number | bigint): {
+        amountDem: number;
+        amountOs: bigint;
+    };
     /**
      * Creates a transaction to claim escrowed funds
      *

package/build/escrow/EscrowTransaction.js

@@ -11,6 +11,7 @@ KyneSys Labs: https://www.kynesys.xyz/
 import { Hashing } from "../encryption/Hashing.js";
 import { uint8ArrayToHex } from "../encryption/unifiedCrypto.js";
 import * as skeletons from "../websdk/utils/skeletons.js";
+import { OS_PER_DEM } from "../denomination/index.js";
 /**
  * High-level API for creating escrow transactions
  * Enables trustless sending of DEM to unclaimed social identities
@@ -31,28 +32,51 @@ export class EscrowTransaction {
         return Hashing.sha3_256(identity);
     }
     /**
-     * Creates a transaction to send DEM to a social identity escrow
+     * Creates a transaction to send DEM to a social identity escrow.
+     *
+     * P4 dual-input:
+     *  - `bigint` (preferred, post-v3): OS amount.
+     *  - `number` (deprecated, v2 callers): DEM amount, auto-converted.
+     *
+     * Internal carrier in `tx.content.amount` and `gcr_edits[].amount`
+     * is bigint OS; the serializerGate (called from `demos.sign`)
+     * picks the wire shape per fork status. Sub-DEM precision against
+     * a pre-fork node throws `SubDemPrecisionError`.
      *
      * @example
      * ```typescript
+     * import { denomination } from "@kynesyslabs/demosdk"
      * const tx = await EscrowTransaction.sendToIdentity(
      *   demos,
      *   "twitter",
      *   "@bob",
-     *   100,
+     *   denomination.demToOs(100),  // 100 DEM
      *   { expiryDays: 30, message: "Welcome to Demos!" }
      * )
-     * await demos.submitTransaction(tx)
+     * await demos.confirm(tx)
      * ```
      *
      * @param demos - Demos SDK instance (must have keypair set)
      * @param platform - Social platform ("twitter", "github", "telegram")
      * @param username - Username on that platform
-     * @param amount - Amount of DEM to send (number)
+     * @param amount - DEM `number` (legacy) or OS `bigint` (preferred).
      * @param options - Optional parameters
      * @returns Signed transaction ready to submit
      */
     static async sendToIdentity(demos, platform, username, amount, options) {
+        // P4 commit 3: bigint OS is the canonical internal carrier; the
+        // serializerGate (run via demos.sign) emits the right wire shape
+        // per the connected node's fork status.
+        const { amountOs } = EscrowTransaction.normalizeAmountInput(amount);
+        // Sub-DEM precision guard — runs before tx construction so the
+        // caller never produces a tx that a pre-fork node will silently
+        // truncate. Calls into the cached `getNetworkInfo` fork status.
+        // The helper is `private` on Demos but reachable at runtime;
+        // cast through `any` to bypass the access modifier (escrow is
+        // package-internal — the alternative is to widen Demos's
+        // public surface, which we don't want).
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        await demos._assertAmountAcceptableOnTargetNode(amountOs);
         // Get sender address from demos instance
         const { publicKey } = await demos.crypto.getIdentity("ed25519");
         const sender = uint8ArrayToHex(publicKey);
@@ -62,14 +86,25 @@ export class EscrowTransaction {
         const nonce = await demos.getAddressNonce(sender);
         // Create empty transaction
         let tx = structuredClone(skeletons.transaction);
-        // Build GCREdits
+        // Build GCREdits. NOTE: `demos.sign()` calls `GCRGeneration.generate`
+        // which currently overwrites `gcr_edits` with edits derived from
+        // the tx content; the inline edits here are dead code today
+        // (flagged in SPEC_P4 §2.1). Kept type-correct so they still
+        // match the (now-widened) `GCREditBalance.amount` type if/when
+        // the dead-code path is wired up.
+        //
+        // P4 commit 3: edits carry bigint OS internally. The
+        // serializerGate normalises them to the right wire shape per
+        // fork status. The `GCREditBalance.amount` static type is
+        // `number | string`; bigints are passed through `unknown` to
+        // satisfy TS — the runtime serializer handles all three shapes.
         const gcrEdits = [
             // 1. Deduct from sender's balance
             {
                 type: "balance",
                 operation: "remove",
                 account: sender,
-                amount: amount,
+                amount: amountOs,
                 txhash: "",
                 isRollback: false,
             },
@@ -82,7 +117,7 @@ export class EscrowTransaction {
                     sender,
                     platform,
                     username,
-                    amount: amount,
+                    amount: amountOs,
                     expiryDays: options?.expiryDays || 30,
                     message: options?.message,
                 },
@@ -90,11 +125,13 @@ export class EscrowTransaction {
                 isRollback: false,
             },
         ];
-        // Fill transaction content
+        // Fill transaction content. Internal carrier is bigint OS; the
+        // serializerGate emits the right wire shape (DEM number pre-fork,
+        // OS string post-fork) when `demos.sign` hashes.
         tx.content.from = sender;
         tx.content.to = escrowAddress;
         tx.content.nonce = nonce + 1;
-        tx.content.amount = amount;
+        tx.content.amount = amountOs;
         tx.content.type = "escrow";
         tx.content.timestamp = Date.now();
         tx.content.gcr_edits = gcrEdits;
@@ -103,13 +140,57 @@ export class EscrowTransaction {
             {
                 platform,
                 username,
-                amount: amount.toString(),
+                // The escrow payload's `amount` is a free-form string here;
+                // emit canonical OS for forward compatibility with the
+                // post-fork node's escrow handler. Pre-fork node tolerates
+                // arbitrary strings on this nested field.
+                amount: amountOs.toString(),
                 operation: "deposit",
             },
         ];
         // Sign transaction
         return await demos.sign(tx);
     }
+    /**
+     * Normalise a public-API amount input (`number` legacy DEM or
+     * `bigint` OS) into both forms. Used at every boundary that needs
+     * dual-shape support during the pre-/post-fork rollout.
+     *
+     * - `number` input: must be a non-negative integer DEM amount;
+     *   converted to OS via `OS_PER_DEM`. Fractional DEM `number` is
+     *   rejected — silently flooring (the previous behaviour) discarded
+     *   up to ~10^9 OS per call. Callers who need sub-DEM precision
+     *   must pass a `bigint` OS amount (e.g. `denomination.demToOs("1.5")`).
+     * - `bigint` input: treated as OS; DEM form is the integer division
+     *   `amountOs / OS_PER_DEM`. The pre-fork sub-DEM precision rejection
+     *   lives in `Demos._assertAmountAcceptableOnTargetNode` (called by
+     *   `sendToIdentity` before this helper runs).
+     *
+     * @internal Exposed only to keep the migration paths discoverable.
+     */
+    static normalizeAmountInput(amount) {
+        if (typeof amount === "bigint") {
+            if (amount < 0n) {
+                throw new Error(`[EscrowTransaction] amount must be non-negative, got ${amount}`);
+            }
+            const amountOs = amount;
+            // Sub-DEM precision is allowed at the bigint level — the
+            // public API rejection lives in `_assertAmountAcceptableOnTargetNode`,
+            // gated on pre-fork node detection. The `amountDem` returned
+            // here is integer-truncated; callers that need exact DEM
+            // should branch on `amountOs % OS_PER_DEM === 0n` first.
+            const amountDem = Number(amountOs / OS_PER_DEM);
+            return { amountDem, amountOs };
+        }
+        if (!Number.isFinite(amount) || amount < 0) {
+            throw new Error(`[EscrowTransaction] amount must be a non-negative finite number or bigint, got ${amount}`);
+        }
+        if (!Number.isInteger(amount)) {
+            throw new Error(`[EscrowTransaction] fractional DEM not supported on the number path (got ${amount}); pass a bigint OS amount via denomination.demToOs("${amount}") instead`);
+        }
+        const amountOs = BigInt(amount) * OS_PER_DEM;
+        return { amountDem: amount, amountOs };
+    }
     /**
      * Creates a transaction to claim escrowed funds
      *

package/build/escrow/EscrowTransaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"EscrowTransaction.js","sourceRoot":"","sources":["../../../src/escrow/EscrowTransaction.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"EscrowTransaction.js","sourceRoot":"","sources":["../../../src/escrow/EscrowTransaction.ts"],"names":[],"mappings":"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"}

package/build/ipfs/IPFSOperations.d.ts

@@ -118,11 +118,28 @@ export interface IPFSPinsResponse {
  * Response from ipfsQuote nodeCall
  *
  * Provides cost estimation before transaction is built and signed.
- * Use this to populate custom_charges in the transaction.
+ * Use this to populate `custom_charges` in the transaction.
+ *
+ * P4 dual-shape compatibility:
+ * - Pre-fork node returns `cost_dem` (decimal string, DEM).
+ * - Post-fork node returns `cost_os` (decimal string, OS).
+ *
+ * SDK helpers (`quoteToCustomCharges`, `createCustomCharges`) prefer
+ * `cost_os` when present and otherwise convert `cost_dem` via
+ * `denomination.demToOs`. Likewise `breakdown.{base_cost,size_cost}` is
+ * shape-stable across the fork.
  */
 export interface IpfsQuoteResponse {
-    /** Estimated cost in DEM (as string for BigInt safety) */
-    cost_dem: string;
+    /**
+     * Estimated cost in DEM as a decimal string (legacy/pre-fork shape).
+     * Kept for back-compat with current node responses.
+     */
+    cost_dem?: string;
+    /**
+     * Estimated cost in OS as a decimal string (post-fork shape).
+     * Preferred when present.
+     */
+    cost_os?: string;
     /** File size used for calculation */
     file_size_bytes: number;
     /** Whether sender is a genesis account */
@@ -147,8 +164,8 @@ export interface IpfsQuoteResponse {
 export interface AddOptionsWithCharges extends AddOptions {
     /** Optional custom charges configuration for cost control */
     customCharges?: {
-        /** Maximum cost user agrees to pay (from ipfsQuote response) */
-        maxCostDem: string;
+        /** Maximum cost user agrees to pay, decimal-string OS (from ipfsQuote response). */
+        maxCostOs: string;
         /** Optional cost breakdown for reference */
         estimatedBreakdown?: IPFSCostBreakdown;
     };
@@ -161,8 +178,8 @@ export interface PinOptionsWithCharges extends PinOptions {
     fileSize?: number;
     /** Optional custom charges configuration for cost control */
     customCharges?: {
-        /** Maximum cost user agrees to pay (from ipfsQuote response) */
-        maxCostDem: string;
+        /** Maximum cost user agrees to pay, decimal-string OS (from ipfsQuote response). */
+        maxCostOs: string;
         /** Optional cost breakdown for reference */
         estimatedBreakdown?: IPFSCostBreakdown;
     };
@@ -221,7 +238,7 @@ export declare class IPFSOperations {
      *   content,
      *   {
      *     filename: 'data.json',
-     *     customCharges: { maxCostDem: quote.cost_dem }
+     *     customCharges: IPFSOperations.quoteToCustomCharges(quote)
      *   }
      * )
      * ```
@@ -251,7 +268,7 @@ export declare class IPFSOperations {
      * const quote = await demos.ipfs.quote(fileSize, 'IPFS_PIN')
      * const chargedPayload = IPFSOperations.createPinPayload('QmExample...', {
      *   fileSize: 1024,
-     *   customCharges: { maxCostDem: quote.cost_dem }
+     *   customCharges: IPFSOperations.quoteToCustomCharges(quote)
      * })
      * ```
      */
@@ -365,9 +382,19 @@ export declare class IPFSOperations {
      * ```
      */
     static quoteToCustomCharges(quote: IpfsQuoteResponse): {
-        maxCostDem: string;
+        maxCostOs: string;
         estimatedBreakdown: IPFSCostBreakdown;
     };
+    /**
+     * Normalise an `IpfsQuoteResponse` into a single canonical OS-decimal
+     * cost string. Prefers `cost_os` (post-fork) over `cost_dem`
+     * (pre-fork). Throws if neither is present or both are unparseable.
+     *
+     * Exposed as a private static helper so internal payload builders and
+     * the public `quoteToCustomCharges` / `createCustomCharges` helpers
+     * share one implementation.
+     */
+    private static _normalizeQuoteCostOs;
     /**
      * Create IPFSCustomCharges object from quote response
      *