1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
|
namespace FundLab.Api
open System
open System.Data
open System.Data.Common
open System.Globalization
open System.Security.Cryptography
open System.Text
open FundLab.Domain
open Npgsql
open NpgsqlTypes
[<CLIMutable>]
type FundCreateCommand =
{
Name: string
InitialCash: decimal
InitialUnitNav: decimal
IsSynthetic: bool
}
type FundRecord =
{
Id: Guid
Name: string
Currency: string
InitialCash: decimal
InitialUnitNav: decimal
IsSynthetic: bool
AvailableCash: decimal
Status: string
}
type FundWriteResult =
| Created of FundRecord
| Replayed of FundRecord
| IdempotencyConflict
| Invalid of string
type FundRepository(connectionString: string) =
let cashMaximum = 999999999999999999.99m
let unitNavMaximum = 99999999999999999999.99999999m
let schema =
"""
CREATE TABLE IF NOT EXISTS funds (
id uuid PRIMARY KEY,
name text NOT NULL,
currency text NOT NULL,
initial_cash numeric(20, 2) NOT NULL,
initial_unit_nav numeric(28, 8) NOT NULL,
is_synthetic boolean NOT NULL,
available_cash numeric(20, 2) NOT NULL,
status text NOT NULL,
created_at timestamptz NOT NULL DEFAULT now()
);
CREATE TABLE IF NOT EXISTS fund_idempotencies (
idempotency_key text PRIMARY KEY,
request_hash text NOT NULL,
fund_id uuid NOT NULL REFERENCES funds(id),
created_at timestamptz NOT NULL DEFAULT now()
);
CREATE TABLE IF NOT EXISTS instruments (
code text PRIMARY KEY CHECK (code ~ '^[0-9]{6}$'),
name text NOT NULL,
fund_type text NULL,
source text NOT NULL,
source_revision text NOT NULL,
source_collected_at timestamptz NOT NULL,
source_payload_hash text NOT NULL,
first_seen_at timestamptz NOT NULL DEFAULT now(),
last_seen_at timestamptz NOT NULL DEFAULT now()
);
CREATE TABLE IF NOT EXISTS fund_nav_observations (
instrument_code text NOT NULL REFERENCES instruments(code),
nav_date date NOT NULL,
published_at timestamptz NULL,
nav numeric(28, 8) NOT NULL,
accumulated_nav numeric(28, 8) NULL,
daily_return numeric(20, 8) NULL,
source text NOT NULL,
source_revision text NOT NULL,
source_collected_at timestamptz NOT NULL,
source_payload_hash text NOT NULL,
first_seen_at timestamptz NOT NULL DEFAULT now(),
last_seen_at timestamptz NOT NULL DEFAULT now(),
PRIMARY KEY (instrument_code, nav_date)
);
CREATE INDEX IF NOT EXISTS fund_nav_observations_date_idx
ON fund_nav_observations (instrument_code, nav_date);
"""
let statusText status =
match status with
| FundStatus.Empty -> "empty"
| FundStatus.Active -> "active"
| FundStatus.ZeroUnits -> "zero_units"
let recordFromLedger (fund: LedgerFund) =
{
Id = fund.Id
Name = fund.Name
Currency = fund.Currency
InitialCash = fund.InitialCash
InitialUnitNav = fund.InitialUnitNav
IsSynthetic = fund.IsSynthetic
AvailableCash = fund.AvailableCash
Status = statusText fund.Status
}
let recordFromReader (reader: DbDataReader) =
{
Id = reader.GetGuid(0)
Name = reader.GetString(1)
Currency = reader.GetString(2)
InitialCash = reader.GetDecimal(3)
InitialUnitNav = reader.GetDecimal(4)
IsSynthetic = reader.GetBoolean(5)
AvailableCash = reader.GetDecimal(6)
Status = reader.GetString(7)
}
let dateTimeOffsetFromReader (reader: DbDataReader) index =
reader.GetFieldValue<DateTimeOffset>(index)
let optionalDateTimeOffsetFromReader (reader: DbDataReader) index =
if reader.IsDBNull(index) then None else Some(dateTimeOffsetFromReader reader index)
let optionalDecimalFromReader (reader: DbDataReader) index =
if reader.IsDBNull(index) then None else Some(reader.GetDecimal(index))
let instrumentRecordFromReader (reader: DbDataReader) : MarketDataInstrumentRecord =
{
Code = reader.GetString(0)
Name = reader.GetString(1)
FundType = if reader.IsDBNull(2) then None else Some(reader.GetString(2))
Source = reader.GetString(3)
SourceRevision = reader.GetString(4)
SourceCollectedAt = dateTimeOffsetFromReader reader 5
SourcePayloadHash = reader.GetString(6)
FirstSeenAt = dateTimeOffsetFromReader reader 7
LastSeenAt = dateTimeOffsetFromReader reader 8
}
let navRecordFromReader (reader: DbDataReader) : MarketDataNavRecord =
{
Code = reader.GetString(0)
NavDate = reader.GetFieldValue<DateOnly>(1)
PublishedAt = optionalDateTimeOffsetFromReader reader 2
Nav = reader.GetDecimal(3)
AccumulatedNav = optionalDecimalFromReader reader 4
DailyReturn = optionalDecimalFromReader reader 5
Source = reader.GetString(6)
SourceRevision = reader.GetString(7)
SourceCollectedAt = dateTimeOffsetFromReader reader 8
SourcePayloadHash = reader.GetString(9)
FirstSeenAt = dateTimeOffsetFromReader reader 10
LastSeenAt = dateTimeOffsetFromReader reader 11
}
let commandWithTransaction (connection: NpgsqlConnection) (transaction: NpgsqlTransaction option) sql =
let command = connection.CreateCommand()
command.CommandText <- sql
match transaction with
| Some value -> command.Transaction <- value
| None -> ()
command
let addParameter (command: NpgsqlCommand) name dbType (value: obj) =
let parameter = command.Parameters.Add(name, dbType)
parameter.Value <- value
parameter
let optionalParameterValue value =
match value with
| Some actual -> box actual
| None -> box DBNull.Value
let findFund connection transaction fundId =
use command =
commandWithTransaction
connection
transaction
"""
SELECT id, name, currency, initial_cash, initial_unit_nav,
is_synthetic, available_cash, status
FROM funds
WHERE id = @fund_id
"""
addParameter command "fund_id" NpgsqlDbType.Uuid (box fundId) |> ignore
use reader = command.ExecuteReader()
if reader.Read() then Some(recordFromReader reader) else None
let findIdempotency connection transaction key =
use command =
commandWithTransaction
connection
transaction
"SELECT request_hash, fund_id FROM fund_idempotencies WHERE idempotency_key = @idempotency_key"
addParameter command "idempotency_key" NpgsqlDbType.Text (box key) |> ignore
use reader = command.ExecuteReader()
if reader.Read() then Some(reader.GetString(0), reader.GetGuid(1)) else None
let insertFund connection transaction (fund: LedgerFund) =
use command =
commandWithTransaction
connection
transaction
"""
INSERT INTO funds
(id, name, currency, initial_cash, initial_unit_nav,
is_synthetic, available_cash, status)
VALUES
(@id, @name, @currency, @initial_cash, @initial_unit_nav,
@is_synthetic, @available_cash, @status)
"""
addParameter command "id" NpgsqlDbType.Uuid (box fund.Id) |> ignore
addParameter command "name" NpgsqlDbType.Text (box fund.Name) |> ignore
addParameter command "currency" NpgsqlDbType.Text (box fund.Currency) |> ignore
addParameter command "initial_cash" NpgsqlDbType.Numeric (box fund.InitialCash) |> ignore
addParameter command "initial_unit_nav" NpgsqlDbType.Numeric (box fund.InitialUnitNav) |> ignore
addParameter command "is_synthetic" NpgsqlDbType.Boolean (box fund.IsSynthetic) |> ignore
addParameter command "available_cash" NpgsqlDbType.Numeric (box fund.AvailableCash) |> ignore
addParameter command "status" NpgsqlDbType.Text (box (statusText fund.Status)) |> ignore
command.ExecuteNonQuery() |> ignore
let insertIdempotency connection transaction key requestHash fundId =
use command =
commandWithTransaction
connection
transaction
"""
INSERT INTO fund_idempotencies (idempotency_key, request_hash, fund_id)
VALUES (@idempotency_key, @request_hash, @fund_id)
"""
addParameter command "idempotency_key" NpgsqlDbType.Text (box key) |> ignore
addParameter command "request_hash" NpgsqlDbType.Text (box requestHash) |> ignore
addParameter command "fund_id" NpgsqlDbType.Uuid (box fundId) |> ignore
command.ExecuteNonQuery() |> ignore
let upsertInstrument connection transaction (payload: MarketDataSearchPayload) payloadHash (instrument: MarketDataInstrument) =
use command =
commandWithTransaction
connection
transaction
"""
INSERT INTO instruments
(code, name, fund_type, source, source_revision,
source_collected_at, source_payload_hash)
VALUES
(@code, @name, @fund_type, @source, @source_revision,
@source_collected_at, @source_payload_hash)
ON CONFLICT (code) DO UPDATE SET
name = EXCLUDED.name,
fund_type = EXCLUDED.fund_type,
source = EXCLUDED.source,
source_revision = EXCLUDED.source_revision,
source_collected_at = EXCLUDED.source_collected_at,
source_payload_hash = EXCLUDED.source_payload_hash,
last_seen_at = now()
"""
addParameter command "code" NpgsqlDbType.Text (box instrument.Code) |> ignore
addParameter command "name" NpgsqlDbType.Text (box instrument.Name) |> ignore
addParameter
command
"fund_type"
NpgsqlDbType.Text
(optionalParameterValue instrument.FundType)
|> ignore
addParameter command "source" NpgsqlDbType.Text (box payload.Source) |> ignore
addParameter command "source_revision" NpgsqlDbType.Text (box payload.SourceRevision) |> ignore
addParameter command "source_collected_at" NpgsqlDbType.TimestampTz (box payload.CollectedAt) |> ignore
addParameter command "source_payload_hash" NpgsqlDbType.Text (box payloadHash) |> ignore
command.ExecuteNonQuery() |> ignore
let upsertNavObservation connection transaction (payload: MarketDataNavPayload) payloadHash (observation: MarketDataObservation) =
use command =
commandWithTransaction
connection
transaction
"""
INSERT INTO fund_nav_observations
(instrument_code, nav_date, published_at, nav, accumulated_nav,
daily_return, source, source_revision, source_collected_at,
source_payload_hash)
VALUES
(@instrument_code, @nav_date, @published_at, @nav, @accumulated_nav,
@daily_return, @source, @source_revision, @source_collected_at,
@source_payload_hash)
ON CONFLICT (instrument_code, nav_date) DO UPDATE SET
published_at = EXCLUDED.published_at,
nav = EXCLUDED.nav,
accumulated_nav = EXCLUDED.accumulated_nav,
daily_return = EXCLUDED.daily_return,
source = EXCLUDED.source,
source_revision = EXCLUDED.source_revision,
source_collected_at = EXCLUDED.source_collected_at,
source_payload_hash = EXCLUDED.source_payload_hash,
last_seen_at = now()
"""
addParameter command "instrument_code" NpgsqlDbType.Text (box payload.Code) |> ignore
addParameter command "nav_date" NpgsqlDbType.Date (box observation.NavDate) |> ignore
addParameter
command
"published_at"
NpgsqlDbType.TimestampTz
(optionalParameterValue observation.PublishedAt)
|> ignore
addParameter command "nav" NpgsqlDbType.Numeric (box observation.Nav) |> ignore
addParameter
command
"accumulated_nav"
NpgsqlDbType.Numeric
(optionalParameterValue observation.AccumulatedNav)
|> ignore
addParameter
command
"daily_return"
NpgsqlDbType.Numeric
(optionalParameterValue observation.DailyReturn)
|> ignore
addParameter command "source" NpgsqlDbType.Text (box payload.Source) |> ignore
addParameter command "source_revision" NpgsqlDbType.Text (box payload.SourceRevision) |> ignore
addParameter command "source_collected_at" NpgsqlDbType.TimestampTz (box payload.CollectedAt) |> ignore
addParameter command "source_payload_hash" NpgsqlDbType.Text (box payloadHash) |> ignore
command.ExecuteNonQuery() |> ignore
let requestHash (command: FundCreateCommand) =
let invariant = CultureInfo.InvariantCulture
let encoded (value: string) = sprintf "%d:%s" value.Length value
let name = if isNull command.Name then "" else command.Name
let payload =
String.concat
"|"
[
"fund-create"
encoded name
(encoded (command.InitialCash.ToString("G29", invariant)))
(encoded (command.InitialUnitNav.ToString("G29", invariant)))
(encoded (command.IsSynthetic.ToString()))
]
Convert.ToHexString(SHA256.HashData(Encoding.UTF8.GetBytes(payload)))
let validateStorageRange (command: FundCreateCommand) =
if command.InitialCash > cashMaximum then
Error "initial cash exceeds database precision"
elif command.InitialUnitNav > unitNavMaximum then
Error "initial unit NAV exceeds database precision"
else
Ok()
let ledgerErrorMessage error =
match error with
| InvalidIdentifier label -> sprintf "%s is invalid" label
| InvalidAmount label -> sprintf "%s is invalid" label
| InvalidPrecision label -> sprintf "%s has invalid precision" label
| InvalidState message -> message
| FundAlreadyExists fundId -> sprintf "fund %O already exists" fundId
| other -> sprintf "%A" other
member _.EnsureSchema() =
use connection = new NpgsqlConnection(connectionString)
connection.Open()
use command = connection.CreateCommand()
command.CommandText <- schema
command.ExecuteNonQuery() |> ignore
member _.GetFund(fundId: Guid) =
use connection = new NpgsqlConnection(connectionString)
connection.Open()
findFund connection None fundId
member _.UpsertInstruments(payload: MarketDataSearchPayload, payloadHash: string) =
use connection = new NpgsqlConnection(connectionString)
connection.Open()
use transaction = connection.BeginTransaction(IsolationLevel.ReadCommitted)
try
for instrument in payload.Instruments do
upsertInstrument connection (Some transaction) payload payloadHash instrument
transaction.Commit()
with error ->
try
transaction.Rollback()
with _ ->
()
raise error
member _.GetInstrument(code: string) =
use connection = new NpgsqlConnection(connectionString)
connection.Open()
use command =
commandWithTransaction
connection
None
"""
SELECT code, name, fund_type, source, source_revision,
source_collected_at, source_payload_hash,
first_seen_at, last_seen_at
FROM instruments
WHERE code = @code
"""
addParameter command "code" NpgsqlDbType.Text (box code) |> ignore
use reader = command.ExecuteReader()
if reader.Read() then Some(instrumentRecordFromReader reader) else None
member _.UpsertNavObservations(payload: MarketDataNavPayload, payloadHash: string) =
use connection = new NpgsqlConnection(connectionString)
connection.Open()
use transaction = connection.BeginTransaction(IsolationLevel.ReadCommitted)
try
for observation in payload.Observations do
upsertNavObservation connection (Some transaction) payload payloadHash observation
transaction.Commit()
with error ->
try
transaction.Rollback()
with _ ->
()
raise error
member _.GetNav(code: string, fromDate: DateOnly option, toDate: DateOnly option) =
use connection = new NpgsqlConnection(connectionString)
connection.Open()
let conditions = ResizeArray<string>()
conditions.Add("instrument_code = @instrument_code")
if fromDate.IsSome then
conditions.Add("nav_date >= @from_date")
if toDate.IsSome then
conditions.Add("nav_date <= @to_date")
use command =
commandWithTransaction
connection
None
(sprintf
"""
SELECT instrument_code, nav_date, published_at, nav, accumulated_nav,
daily_return, source, source_revision, source_collected_at,
source_payload_hash, first_seen_at, last_seen_at
FROM fund_nav_observations
WHERE %s
ORDER BY nav_date ASC
"""
(String.concat " AND " conditions))
addParameter command "instrument_code" NpgsqlDbType.Text (box code) |> ignore
match fromDate with
| Some value -> addParameter command "from_date" NpgsqlDbType.Date (box value) |> ignore
| None -> ()
match toDate with
| Some value -> addParameter command "to_date" NpgsqlDbType.Date (box value) |> ignore
| None -> ()
use reader = command.ExecuteReader()
let records = ResizeArray<MarketDataNavRecord>()
while reader.Read() do
records.Add(navRecordFromReader reader)
records |> Seq.toList
member _.CreateFund(idempotencyKey: string, command: FundCreateCommand) =
if String.IsNullOrWhiteSpace idempotencyKey then
FundWriteResult.Invalid "idempotency key cannot be empty"
else
match validateStorageRange command with
| Error message -> FundWriteResult.Invalid message
| Ok() ->
let fingerprint = requestHash command
use connection = new NpgsqlConnection(connectionString)
connection.Open()
use transaction = connection.BeginTransaction(IsolationLevel.ReadCommitted)
try
use lockCommand =
commandWithTransaction
connection
(Some transaction)
"SELECT pg_advisory_xact_lock(hashtext(@lock_key))"
addParameter lockCommand "lock_key" NpgsqlDbType.Text (box idempotencyKey) |> ignore
lockCommand.ExecuteNonQuery() |> ignore
match findIdempotency connection (Some transaction) idempotencyKey with
| Some(existingHash, fundId) when existingHash = fingerprint ->
match findFund connection (Some transaction) fundId with
| Some fund ->
transaction.Commit()
FundWriteResult.Replayed fund
| None ->
transaction.Rollback()
FundWriteResult.Invalid "idempotency record references a missing fund"
| Some _ ->
transaction.Rollback()
FundWriteResult.IdempotencyConflict
| None ->
let fundId = Guid.NewGuid()
match Ledger.initializeFund fundId command.Name command.InitialCash command.InitialUnitNav command.IsSynthetic Ledger.empty with
| Error error ->
transaction.Rollback()
FundWriteResult.Invalid(ledgerErrorMessage error)
| Ok state ->
match Ledger.getFund fundId state with
| Error error ->
transaction.Rollback()
FundWriteResult.Invalid(ledgerErrorMessage error)
| Ok fund ->
insertFund connection (Some transaction) fund
insertIdempotency connection (Some transaction) idempotencyKey fingerprint fundId
transaction.Commit()
FundWriteResult.Created(recordFromLedger fund)
with error ->
try
transaction.Rollback()
with _ ->
()
raise error
|