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
|
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()
);
"""
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 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 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 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 _.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
|