@agoric/ertp 0.16.3-other-dev-3eb1a1d.0 → 0.16.3-other-dev-fbe72e7.0.fbe72e7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/src/ratio.d.ts ADDED
@@ -0,0 +1,48 @@
1
+ export function assertIsRatio(ratio: any): void;
2
+ export function makeRatio(numerator: bigint, numeratorBrand: Brand, denominator?: bigint, denominatorBrand?: Brand): Ratio;
3
+ export function makeRatioFromAmounts(numeratorAmount: Amount, denominatorAmount: Amount): Ratio;
4
+ /** @type {ScaleAmount} */
5
+ export const floorMultiplyBy: ScaleAmount;
6
+ /** @type {ScaleAmount} */
7
+ export const ceilMultiplyBy: ScaleAmount;
8
+ /** @type {ScaleAmount} */
9
+ export const multiplyBy: ScaleAmount;
10
+ /**
11
+ * Divide the amount by the ratio, truncating the remainder.
12
+ *
13
+ * @type {ScaleAmount}
14
+ */
15
+ export const floorDivideBy: ScaleAmount;
16
+ /**
17
+ * Divide the amount by the ratio, rounding up the remainder.
18
+ *
19
+ * @type {ScaleAmount}
20
+ */
21
+ export const ceilDivideBy: ScaleAmount;
22
+ /**
23
+ * Divide the amount by the ratio, rounding to nearest with ties to even (aka
24
+ * Banker's Rounding) as in IEEE 754 default rounding.
25
+ *
26
+ * @type {ScaleAmount}
27
+ */
28
+ export const divideBy: ScaleAmount;
29
+ export function invertRatio(ratio: Ratio): Ratio;
30
+ export function addRatios(left: Ratio, right: Ratio): Ratio;
31
+ export function subtractRatios(left: Ratio, right: Ratio): Ratio;
32
+ export function multiplyRatios(left: Ratio, right: Ratio): Ratio;
33
+ export function oneMinus(ratio: Ratio): Ratio;
34
+ export function ratioGTE(left: Ratio, right: Ratio): boolean;
35
+ export function ratiosSame(left: Ratio, right: Ratio): boolean;
36
+ export function quantize(ratio: Ratio, newDen: bigint): Ratio;
37
+ export function parseRatio(numeric: ParsableNumber, numeratorBrand: Brand<"nat">, denominatorBrand?: Brand<"nat">): Ratio;
38
+ export function assertParsableNumber(specimen: unknown): asserts specimen is ParsableNumber;
39
+ export function ratioToNumber(ratio: Ratio): number;
40
+ export type Ratio = {
41
+ numerator: Amount<"nat">;
42
+ denominator: Amount<"nat">;
43
+ };
44
+ export type ScaleAmount = (amount: Amount<"nat">, ratio: Ratio) => Amount<"nat">;
45
+ export type ParsableNumber = bigint | number | string;
46
+ import type { Brand } from '@agoric/ertp';
47
+ import type { Amount } from '@agoric/ertp';
48
+ //# sourceMappingURL=ratio.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ratio.d.ts","sourceRoot":"","sources":["ratio.js"],"names":[],"mappings":"AAwDO,gDAcN;AASM,qCANI,MAAM,kBACN,KAAK,gBACL,MAAM,qBACN,KAAK,GACH,KAAK,CAejB;AAOM,sDAJI,MAAM,qBACN,MAAM,GACJ,KAAK,CAYjB;AA2BD,0BAA0B;AAC1B,8BADW,WAAW,CAGpB;AAEF,0BAA0B;AAC1B,6BADW,WAAW,CAGpB;AAEF,0BAA0B;AAC1B,yBADW,WAAW,CAGpB;AA2BF;;;;GAIG;AACH,4BAFU,WAAW,CAInB;AAEF;;;;GAIG;AACH,2BAFU,WAAW,CAInB;AAEF;;;;;GAKG;AACH,uBAFU,WAAW,CAInB;AAMK,mCAHI,KAAK,GACH,KAAK,CAWjB;AAOM,gCAJI,KAAK,SACL,KAAK,GACH,KAAK,CAwBjB;AAOM,qCAJI,KAAK,SACL,KAAK,GACH,KAAK,CAmBjB;AAOM,qCAJI,KAAK,SACL,KAAK,GACH,KAAK,CA8BjB;AAQM,gCAHI,KAAK,GACH,KAAK,CAcjB;AAOM,+BAJI,KAAK,SACL,KAAK,GACH,OAAO,CAkBnB;AAUM,iCAJI,KAAK,SACL,KAAK,GACH,OAAO,CAOnB;AAWM,gCAJI,KAAK,UACL,MAAM,GACJ,KAAK,CAiBjB;AAaM,oCALI,cAAc,kBACd,MAAM,KAAK,CAAC,qBACZ,MAAM,KAAK,CAAC,GACV,KAAK,CAmBjB;AAMM,+CAHI,OAAO,GACL,QAAQ,QAAQ,IAAI,cAAc,CAK9C;AAQM,qCAHI,KAAK,GACH,MAAM,CAMlB;;eAxaa,OAAO,KAAK,CAAC;iBACb,OAAO,KAAK,CAAC;;mCAKhB,OAAO,KAAK,CAAC,SACb,KAAK,KACH,OAAO,KAAK,CAAC;6BAgXZ,MAAM,GAAG,MAAM,GAAG,MAAM;2BAhYkB,cAAc;4BAAd,cAAc"}
package/src/ratio.js ADDED
@@ -0,0 +1,441 @@
1
+ import { q, Fail } from '@endo/errors';
2
+ import { assertRecord } from '@endo/marshal';
3
+ import { isNat } from '@endo/nat';
4
+
5
+ import { AmountMath } from './amountMath.js';
6
+ import { natSafeMath } from './safeMath.js';
7
+
8
+ /**
9
+ * @import {Amount, Brand, Issuer, Payment, Purse} from '@agoric/ertp';
10
+ */
11
+
12
+ const { multiply, floorDivide, ceilDivide, bankersDivide, add, subtract } =
13
+ natSafeMath;
14
+
15
+ /**
16
+ * @typedef {object} Ratio
17
+ * @property {Amount<'nat'>} numerator
18
+ * @property {Amount<'nat'>} denominator
19
+ */
20
+
21
+ /**
22
+ * @callback ScaleAmount
23
+ * @param {Amount<'nat'>} amount
24
+ * @param {Ratio} ratio
25
+ * @returns {Amount<'nat'>}
26
+ */
27
+
28
+ // make a Ratio, which represents a fraction. It is a pass-by-copy record.
29
+ //
30
+ // The natural syntax for the most common operations we want to support
31
+ // are Amount * Ratio and Amount / Ratio. Since the operations want to adhere to
32
+ // the ratio rather than the amount, we settled on a calling convention of
33
+ // [ceil|floor]MultiplyBy(Amount, Ratio) and [ceil|floor]DivideBy(Amount, Ratio)
34
+ //
35
+ // The most common kind of Ratio can be applied to Amounts of a particular
36
+ // brand, and produces results of the same brand. This represents a multiplier
37
+ // that is only applicable to that brand. The less common kind of Ratio can be
38
+ // applied to one particular brand of amounts, and produces results of another
39
+ // particular brand. This represents some kind of exchange rate. The
40
+ // brand-checking helps us ensure that normal Ratios aren't applied to amounts
41
+ // of the wrong brand, and that exchange rates are only used in the appropriate
42
+ // direction.
43
+ //
44
+ // Since the ratios are represented by a numerator and a denominator, every
45
+ // multiplication or division operation that produces an amount ends with a
46
+ // division of the underlying bigints, and integer division requires a mode
47
+ // of [rounding to integer](https://en.wikipedia.org/wiki/Rounding#Rounding_to_integer).
48
+ // Because `Ratio` only work with Natural numbers, just three modes suffice:
49
+ // - floor rounds down
50
+ // - ceil rounds up
51
+ // - default (without prefix) minimizes bias by rounding half to even
52
+
53
+ const PERCENT = 100n;
54
+
55
+ const ratioPropertyNames = ['numerator', 'denominator'];
56
+
57
+ export const assertIsRatio = ratio => {
58
+ assertRecord(ratio, 'ratio');
59
+ const keys = Object.keys(ratio);
60
+ keys.length === 2 || Fail`Ratio ${ratio} must be a record with 2 fields.`;
61
+ for (const name of keys) {
62
+ ratioPropertyNames.includes(name) ||
63
+ Fail`Parameter must be a Ratio record, but ${ratio} has ${q(name)}`;
64
+ }
65
+ const numeratorValue = ratio.numerator.value;
66
+ const denominatorValue = ratio.denominator.value;
67
+ isNat(numeratorValue) ||
68
+ Fail`The numerator value must be a NatValue, not ${numeratorValue}`;
69
+ isNat(denominatorValue) ||
70
+ Fail`The denominator value must be a NatValue, not ${denominatorValue}`;
71
+ };
72
+
73
+ /**
74
+ * @param {bigint} numerator
75
+ * @param {Brand} numeratorBrand
76
+ * @param {bigint} [denominator] The default denominator is 100
77
+ * @param {Brand} [denominatorBrand] The default is to reuse the numeratorBrand
78
+ * @returns {Ratio}
79
+ */
80
+ export const makeRatio = (
81
+ numerator,
82
+ numeratorBrand,
83
+ denominator = PERCENT,
84
+ denominatorBrand = numeratorBrand,
85
+ ) => {
86
+ denominator > 0n ||
87
+ Fail`No infinite ratios! Denominator was 0 ${q(denominatorBrand)}`;
88
+
89
+ return harden({
90
+ numerator: AmountMath.make(numeratorBrand, numerator),
91
+ denominator: AmountMath.make(denominatorBrand, denominator),
92
+ });
93
+ };
94
+
95
+ /**
96
+ * @param {Amount} numeratorAmount
97
+ * @param {Amount} denominatorAmount
98
+ * @returns {Ratio}
99
+ */
100
+ export const makeRatioFromAmounts = (numeratorAmount, denominatorAmount) => {
101
+ AmountMath.coerce(numeratorAmount.brand, numeratorAmount);
102
+ AmountMath.coerce(denominatorAmount.brand, denominatorAmount);
103
+ return makeRatio(
104
+ // @ts-expect-error value can be any AmountValue but makeRatio() supports only bigint
105
+ numeratorAmount.value,
106
+ numeratorAmount.brand,
107
+ denominatorAmount.value,
108
+ denominatorAmount.brand,
109
+ );
110
+ };
111
+
112
+ /**
113
+ * @param {Amount<'nat'>} amount
114
+ * @param {Ratio} ratio
115
+ * @param {any} divideOp
116
+ * @returns {Amount<'nat'>}
117
+ */
118
+ const multiplyHelper = (amount, ratio, divideOp) => {
119
+ AmountMath.coerce(amount.brand, amount);
120
+ assertIsRatio(ratio);
121
+ amount.brand === ratio.denominator.brand ||
122
+ Fail`amount's brand ${q(amount.brand)} must match ratio's denominator ${q(
123
+ ratio.denominator.brand,
124
+ )}`;
125
+
126
+ return /** @type {Amount<'nat'>} */ (
127
+ AmountMath.make(
128
+ ratio.numerator.brand,
129
+ divideOp(
130
+ multiply(amount.value, ratio.numerator.value),
131
+ ratio.denominator.value,
132
+ ),
133
+ )
134
+ );
135
+ };
136
+
137
+ /** @type {ScaleAmount} */
138
+ export const floorMultiplyBy = (amount, ratio) => {
139
+ return multiplyHelper(amount, ratio, floorDivide);
140
+ };
141
+
142
+ /** @type {ScaleAmount} */
143
+ export const ceilMultiplyBy = (amount, ratio) => {
144
+ return multiplyHelper(amount, ratio, ceilDivide);
145
+ };
146
+
147
+ /** @type {ScaleAmount} */
148
+ export const multiplyBy = (amount, ratio) => {
149
+ return multiplyHelper(amount, ratio, bankersDivide);
150
+ };
151
+
152
+ /**
153
+ * @param {Amount<'nat'>} amount
154
+ * @param {Ratio} ratio
155
+ * @param {any} divideOp
156
+ * @returns {Amount<'nat'>}
157
+ */
158
+ const divideHelper = (amount, ratio, divideOp) => {
159
+ AmountMath.coerce(amount.brand, amount);
160
+ assertIsRatio(ratio);
161
+ amount.brand === ratio.numerator.brand ||
162
+ Fail`amount's brand ${q(amount.brand)} must match ratio's numerator ${q(
163
+ ratio.numerator.brand,
164
+ )}`;
165
+
166
+ return /** @type {Amount<'nat'>} */ (
167
+ AmountMath.make(
168
+ ratio.denominator.brand,
169
+ divideOp(
170
+ multiply(amount.value, ratio.denominator.value),
171
+ ratio.numerator.value,
172
+ ),
173
+ )
174
+ );
175
+ };
176
+
177
+ /**
178
+ * Divide the amount by the ratio, truncating the remainder.
179
+ *
180
+ * @type {ScaleAmount}
181
+ */
182
+ export const floorDivideBy = (amount, ratio) => {
183
+ return divideHelper(amount, ratio, floorDivide);
184
+ };
185
+
186
+ /**
187
+ * Divide the amount by the ratio, rounding up the remainder.
188
+ *
189
+ * @type {ScaleAmount}
190
+ */
191
+ export const ceilDivideBy = (amount, ratio) => {
192
+ return divideHelper(amount, ratio, ceilDivide);
193
+ };
194
+
195
+ /**
196
+ * Divide the amount by the ratio, rounding to nearest with ties to even (aka
197
+ * Banker's Rounding) as in IEEE 754 default rounding.
198
+ *
199
+ * @type {ScaleAmount}
200
+ */
201
+ export const divideBy = (amount, ratio) => {
202
+ return divideHelper(amount, ratio, bankersDivide);
203
+ };
204
+
205
+ /**
206
+ * @param {Ratio} ratio
207
+ * @returns {Ratio}
208
+ */
209
+ export const invertRatio = ratio => {
210
+ assertIsRatio(ratio);
211
+
212
+ return makeRatio(
213
+ ratio.denominator.value,
214
+ ratio.denominator.brand,
215
+ ratio.numerator.value,
216
+ ratio.numerator.brand,
217
+ );
218
+ };
219
+
220
+ /**
221
+ * @param {Ratio} left
222
+ * @param {Ratio} right
223
+ * @returns {Ratio}
224
+ */
225
+ export const addRatios = (left, right) => {
226
+ assertIsRatio(right);
227
+ assertIsRatio(left);
228
+ left.numerator.brand === right.numerator.brand ||
229
+ Fail`numerator brands must match: ${q(left)} ${q(right)}`;
230
+ left.denominator.brand === right.denominator.brand ||
231
+ Fail`denominator brands must match: ${q(left)} ${q(right)}`;
232
+
233
+ // Simplifying the expression:
234
+ // (and + bnd) / y d**2
235
+ // (a + b) nd / y d**2
236
+ // ((a + b) n / y d) * (d / d)
237
+ // (a + b) n / yd
238
+ return makeRatio(
239
+ add(
240
+ multiply(left.numerator.value, right.denominator.value), // a nd
241
+ multiply(left.denominator.value, right.numerator.value), // b nd
242
+ ), // (a + b) nd
243
+ left.numerator.brand,
244
+ multiply(left.denominator.value, right.denominator.value), // y d**2
245
+ left.denominator.brand,
246
+ );
247
+ };
248
+
249
+ /**
250
+ * @param {Ratio} left
251
+ * @param {Ratio} right
252
+ * @returns {Ratio}
253
+ */
254
+ export const subtractRatios = (left, right) => {
255
+ assertIsRatio(right);
256
+ assertIsRatio(left);
257
+ left.numerator.brand === right.numerator.brand ||
258
+ Fail`numerator brands must match: ${q(left)} ${q(right)}`;
259
+ left.denominator.brand === right.denominator.brand ||
260
+ Fail`denominator brands must match: ${q(left)} ${q(right)}`;
261
+
262
+ return makeRatio(
263
+ subtract(
264
+ multiply(left.numerator.value, right.denominator.value), // a nd
265
+ multiply(left.denominator.value, right.numerator.value), // b nd
266
+ ), // (a - b) nd
267
+ left.numerator.brand,
268
+ multiply(left.denominator.value, right.denominator.value), // y d**2
269
+ left.denominator.brand,
270
+ );
271
+ };
272
+
273
+ /**
274
+ * @param {Ratio} left
275
+ * @param {Ratio} right
276
+ * @returns {Ratio}
277
+ */
278
+ export const multiplyRatios = (left, right) => {
279
+ assertIsRatio(right);
280
+ assertIsRatio(left);
281
+
282
+ const getRemainingBrands = () => {
283
+ // Prefer results that have the same brand as the left operand.
284
+ if (right.numerator.brand === right.denominator.brand) {
285
+ return [left.numerator.brand, left.denominator.brand];
286
+ }
287
+ if (right.numerator.brand === left.denominator.brand) {
288
+ return [left.numerator.brand, right.denominator.brand];
289
+ }
290
+ if (left.numerator.brand === right.denominator.brand) {
291
+ return [right.numerator.brand, left.denominator.brand];
292
+ }
293
+ if (left.numerator.brand === left.denominator.brand) {
294
+ return [right.numerator.brand, right.denominator.brand];
295
+ }
296
+ throw Fail`at least one brand must cancel out: ${q(left)} ${q(right)}`;
297
+ };
298
+
299
+ const [numeratorBrand, denominatorBrand] = getRemainingBrands();
300
+ return makeRatio(
301
+ multiply(left.numerator.value, right.numerator.value),
302
+ numeratorBrand,
303
+ multiply(left.denominator.value, right.denominator.value),
304
+ denominatorBrand,
305
+ );
306
+ };
307
+
308
+ /**
309
+ * If ratio is between 0 and 1, subtract from 1.
310
+ *
311
+ * @param {Ratio} ratio
312
+ * @returns {Ratio}
313
+ */
314
+ export const oneMinus = ratio => {
315
+ assertIsRatio(ratio);
316
+ ratio.numerator.brand === ratio.denominator.brand ||
317
+ Fail`oneMinus only supports ratios with a single brand, but ${ratio.numerator.brand} doesn't match ${ratio.denominator.brand}`;
318
+ ratio.numerator.value <= ratio.denominator.value ||
319
+ Fail`Parameter must be less than or equal to 1: ${ratio.numerator.value}/${ratio.denominator.value}`;
320
+ return makeRatio(
321
+ subtract(ratio.denominator.value, ratio.numerator.value),
322
+ ratio.numerator.brand,
323
+ ratio.denominator.value,
324
+ ratio.numerator.brand,
325
+ );
326
+ };
327
+
328
+ /**
329
+ * @param {Ratio} left
330
+ * @param {Ratio} right
331
+ * @returns {boolean}
332
+ */
333
+ export const ratioGTE = (left, right) => {
334
+ if (left.numerator.brand === right.numerator.brand) {
335
+ left.denominator.brand === right.denominator.brand ||
336
+ Fail`numerator brands match, but denominator brands don't: ${q(left)} ${q(
337
+ right,
338
+ )}`;
339
+ } else if (left.numerator.brand === left.denominator.brand) {
340
+ right.numerator.brand === right.denominator.brand ||
341
+ Fail`lefthand brands match, but righthand brands don't: ${q(left)} ${q(
342
+ right,
343
+ )}`;
344
+ }
345
+ return natSafeMath.isGTE(
346
+ multiply(left.numerator.value, right.denominator.value),
347
+ multiply(right.numerator.value, left.denominator.value),
348
+ );
349
+ };
350
+
351
+ /**
352
+ * True iff the ratios are the same values (equal or equivalant may return
353
+ * false)
354
+ *
355
+ * @param {Ratio} left
356
+ * @param {Ratio} right
357
+ * @returns {boolean}
358
+ */
359
+ export const ratiosSame = (left, right) => {
360
+ return (
361
+ AmountMath.isEqual(left.numerator, right.numerator) &&
362
+ AmountMath.isEqual(left.denominator, right.denominator)
363
+ );
364
+ };
365
+
366
+ /**
367
+ * Make a new ratio with a smaller denominator that approximates the ratio. If
368
+ * the proposed denominator is larger than the current one, return the
369
+ * original.
370
+ *
371
+ * @param {Ratio} ratio
372
+ * @param {bigint} newDen
373
+ * @returns {Ratio}
374
+ */
375
+ export const quantize = (ratio, newDen) => {
376
+ const oldDen = ratio.denominator.value;
377
+ const oldNum = ratio.numerator.value;
378
+ if (newDen > oldDen) {
379
+ return ratio;
380
+ }
381
+
382
+ const newNum =
383
+ newDen === oldDen ? oldNum : bankersDivide(oldNum * newDen, oldDen);
384
+ return makeRatio(
385
+ newNum,
386
+ ratio.numerator.brand,
387
+ newDen,
388
+ ratio.denominator.brand,
389
+ );
390
+ };
391
+
392
+ const NUMERIC_RE = /^(\d\d*)(?:\.(\d*))?$/;
393
+ /** @typedef {bigint | number | string} ParsableNumber */
394
+
395
+ /**
396
+ * Create a ratio from a given numeric value.
397
+ *
398
+ * @param {ParsableNumber} numeric
399
+ * @param {Brand<'nat'>} numeratorBrand
400
+ * @param {Brand<'nat'>} [denominatorBrand]
401
+ * @returns {Ratio}
402
+ */
403
+ export const parseRatio = (
404
+ numeric,
405
+ numeratorBrand,
406
+ denominatorBrand = numeratorBrand,
407
+ ) => {
408
+ const match = `${numeric}`.match(NUMERIC_RE);
409
+ if (!match) {
410
+ throw Fail`Invalid numeric data: ${numeric}`;
411
+ }
412
+
413
+ const [_, whole, part = ''] = match;
414
+ return makeRatio(
415
+ BigInt(`${whole}${part}`),
416
+ numeratorBrand,
417
+ 10n ** BigInt(part.length),
418
+ denominatorBrand,
419
+ );
420
+ };
421
+
422
+ /**
423
+ * @param {unknown} specimen
424
+ * @returns {asserts specimen is ParsableNumber}
425
+ */
426
+ export const assertParsableNumber = specimen => {
427
+ const match = `${specimen}`.match(NUMERIC_RE);
428
+ match || Fail`Invalid numeric data: ${specimen}`;
429
+ };
430
+
431
+ /**
432
+ * Ratios might be greater or less than one.
433
+ *
434
+ * @param {Ratio} ratio
435
+ * @returns {number}
436
+ */
437
+ export const ratioToNumber = ratio => {
438
+ const n = Number(ratio.numerator.value);
439
+ const d = Number(ratio.denominator.value);
440
+ return n / d;
441
+ };
@@ -0,0 +1,11 @@
1
+ export namespace natSafeMath {
2
+ let add: NatOp;
3
+ let subtract: NatOp;
4
+ let multiply: NatOp;
5
+ let floorDivide: NatOp;
6
+ let ceilDivide: NatOp;
7
+ let bankersDivide: NatOp;
8
+ let isGTE: (x: number | bigint, y: number | bigint) => boolean;
9
+ }
10
+ export type NatOp = (x: number | bigint, y: number | bigint) => bigint;
11
+ //# sourceMappingURL=safeMath.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"safeMath.d.ts","sourceRoot":"","sources":["safeMath.js"],"names":[],"mappings":";aAYa,KAAK;kBAGL,KAAK;kBAEL,KAAK;qBAEL,KAAK;oBAEL,KAAK;uBASN,KAAK;eAiBJ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,KAAK,OAAO;;oBA7ClD,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,KAAK,MAAM"}
@@ -0,0 +1,50 @@
1
+ import { Nat } from '@endo/nat';
2
+
3
+ /** @typedef {(x: number | bigint, y: number | bigint) => bigint} NatOp */
4
+
5
+ /**
6
+ * These operations should be used for calculations with the values of basic
7
+ * fungible tokens.
8
+ *
9
+ * natSafeMath is designed to be used directly, and so it needs to validate the
10
+ * inputs, as well as the outputs when necessary.
11
+ */
12
+ export const natSafeMath = harden({
13
+ /** @type {NatOp} */
14
+ // BigInts don't observably overflow
15
+ add: (x, y) => Nat(x) + Nat(y),
16
+ /** @type {NatOp} */
17
+ subtract: (x, y) => Nat(Nat(x) - Nat(y)),
18
+ /** @type {NatOp} */
19
+ multiply: (x, y) => Nat(x) * Nat(y),
20
+ /** @type {NatOp} */
21
+ floorDivide: (x, y) => Nat(x) / Nat(y),
22
+ /** @type {NatOp} */
23
+ ceilDivide: (x, y) => {
24
+ y = Nat(y);
25
+ return Nat(Nat(x) + y - 1n) / y;
26
+ },
27
+ /**
28
+ * Divide using half-to-even (aka Banker's Rounding) as in IEEE 774 default
29
+ * rounding
30
+ *
31
+ * @type {NatOp}
32
+ */
33
+ bankersDivide: (a, b) => {
34
+ a = Nat(a);
35
+ b = Nat(b);
36
+
37
+ const div = a / b;
38
+ const rem = a % b;
39
+ // if remainder > half divisor, should have rounded up instead of down, so add 1
40
+ if (rem * 2n > b) {
41
+ return div + 1n;
42
+ } else if (rem * 2n === b) {
43
+ // Add 1 if result is odd to get an even return value
44
+ if (div % 2n === 1n) return div + 1n;
45
+ }
46
+ return div;
47
+ },
48
+ /** @type {(x: number | bigint, y: number | bigint) => boolean} */
49
+ isGTE: (x, y) => Nat(x) >= Nat(y),
50
+ });
@@ -1,6 +1,7 @@
1
1
  /**
2
2
  * @import {AmountValue, Ratio} from './types.js'
3
3
  * @import {TypedPattern} from '@agoric/internal'
4
+ * @import {CopyBag, CopySet, Pattern} from '@endo/patterns';
4
5
  */
5
6
  export const BrandShape: import("@endo/patterns").Matcher;
6
7
  export const IssuerShape: import("@endo/patterns").Matcher;
@@ -85,5 +86,8 @@ declare const AmountValueShape: import("@endo/patterns").Matcher;
85
86
  import type { Ratio } from './types.js';
86
87
  import type { TypedPattern } from '@agoric/internal';
87
88
  import type { AmountValue } from './types.js';
89
+ import type { CopySet } from '@endo/patterns';
90
+ import type { CopyBag } from '@endo/patterns';
91
+ import type { Pattern } from '@endo/patterns';
88
92
  export {};
89
93
  //# sourceMappingURL=typeGuards.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"typeGuards.d.ts","sourceRoot":"","sources":["typeGuards.js"],"names":[],"mappings":"AAGA;;;GAGG;AAEH,0DAA+C;AAC/C,2DAAiD;AACjD,4DAAmD;AACnD,0DAA+C;AAC/C,iEAA6D;AAC7D,6DAAqD;AACrD,yDAA6C;;;;;AAkE7C;;;;;;;;;;GAUG;AACH,kEAA8C;AAE9C,kCAAkC;AAClC,yBADW,aAAa,KAAK,CAAC,CACiD;AASxE,kCAHI,WAAW,GACT,KAAK,IAAI,OAAO,YAAY,EAAE,QAAQ,CAEa;AASzD,sCAHI,WAAW,GACT,KAAK,IAAI,OAAO,CAE2C;AAYjE,kCAHI,WAAW,GACT,KAAK,IAAI,QAAQ,CAEkC;AASzD,sCAHI,WAAW,GACT,KAAK,IAAI,OAAO,CAE2C;AAIxE,8CAA+C;AAE/C,8DAAuE;AAEvE,gEAaE;;;;;;;;AAaF;;;;;GAKG;AAOI,kDAJI,OAAO,mBACP,OAAO,gBACP,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqEjB;AAhLD,iEAKE;2BAvEmC,YAAY;kCAClB,kBAAkB;iCADZ,YAAY"}
1
+ {"version":3,"file":"typeGuards.d.ts","sourceRoot":"","sources":["typeGuards.js"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,0DAA+C;AAC/C,2DAAiD;AACjD,4DAAmD;AACnD,0DAA+C;AAC/C,iEAA6D;AAC7D,6DAAqD;AACrD,yDAA6C;;;;;AAkE7C;;;;;;;;;;GAUG;AACH,kEAA8C;AAE9C,kCAAkC;AAClC,yBADW,aAAa,KAAK,CAAC,CACiD;AASxE,kCAHI,WAAW,GACT,KAAK,IAAI,OAAO,YAAY,EAAE,QAAQ,CAEa;AASzD,sCAHI,WAAW,GACT,KAAK,IAAI,OAAO,CAE2C;AAYjE,kCAHI,WAAW,GACT,KAAK,IAAI,QAAQ,CAEkC;AASzD,sCAHI,WAAW,GACT,KAAK,IAAI,OAAO,CAE2C;AAIxE,0CAA2C,GAAG,CAAC;AAE/C,8DAAuE;AAEvE,gEAaE;;;;;;;;AAaF;;;;;GAKG;AAOI,kDAJI,OAAO,mBACP,OAAO,gBACP,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqEjB;AAhLD,iEAKE;2BAxEmC,YAAY;kCAClB,kBAAkB;iCADZ,YAAY;6BAEL,gBAAgB;6BAAhB,gBAAgB;6BAAhB,gBAAgB"}
package/src/typeGuards.js CHANGED
@@ -4,6 +4,7 @@ import { M, matches, getInterfaceGuardPayload } from '@endo/patterns';
4
4
  /**
5
5
  * @import {AmountValue, Ratio} from './types.js'
6
6
  * @import {TypedPattern} from '@agoric/internal'
7
+ * @import {CopyBag, CopySet, Pattern} from '@endo/patterns';
7
8
  */
8
9
 
9
10
  export const BrandShape = M.remotable('Brand');
package/src/types.d.ts CHANGED
@@ -2,6 +2,7 @@ import type { LatestTopic } from '@agoric/notifier';
2
2
  import type { ERef } from '@endo/far';
3
3
  import type { RemotableObject } from '@endo/pass-style';
4
4
  import type { CopyBag, CopySet, Key, Pattern } from '@endo/patterns';
5
+ import type { TypeTag } from '@agoric/internal/src/tagged.js';
5
6
  import type { AssetKind } from './amountMath.js';
6
7
  export type { AssetKind } from './amountMath.js';
7
8
  export type NatAmount = {
@@ -346,8 +347,7 @@ export type PurseMethods<K extends AssetKind = AssetKind, M extends Key = Key> =
346
347
  * `issuer.makeEmptyPurse()` to create a purse, then
347
348
  * `purse.deposit(payment)`.
348
349
  */
349
- export type Payment<K extends AssetKind = AssetKind, M extends Key = Key> = RemotableObject & PaymentMethods<K>;
350
- export type PaymentMethods<K extends AssetKind = AssetKind> = {
350
+ export type Payment<K extends AssetKind = AssetKind, M extends Key = Key> = RemotableObject & TypeTag<{
351
351
  /**
352
352
  * Get the allegedBrand, indicating
353
353
  * the type of digital asset this payment purports to be, and which issuer to
@@ -355,7 +355,7 @@ export type PaymentMethods<K extends AssetKind = AssetKind> = {
355
355
  * be treated with suspicion and verified elsewhere.
356
356
  */
357
357
  getAllegedBrand: () => Brand<K>;
358
- };
358
+ }, 'Set-like value type', M>;
359
359
  /**
360
360
  * All of the difference in how digital asset
361
361
  * amount are manipulated can be reduced to the behavior of the math on
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"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"}