ci: regenerated with OpenAPI Doc , Speakeasy CLI 1.565.0

Author: speakeasybot

.gitignore

@@ -1,3 +1,5 @@
+**/.speakeasy/temp/
+**/.speakeasy/logs/
 composer.lock
 vendor
 .DS_Store

.speakeasy/gen.lock

@@ -1,4 +1,4 @@
-speakeasyVersion: 1.521.1
+speakeasyVersion: 1.565.0
 sources:
     my-source:
         sourceNamespace: my-source
@@ -9,20 +9,20 @@ sources:
             - main
     stacks-source:
         sourceNamespace: stacks-source
-        sourceRevisionDigest: sha256:7cb558a099e645b1d753a57048c9154429c99e3a7e971567881ab9d26e478f67
-        sourceBlobDigest: sha256:f425dd02ba31efb8d82cd4e74907e8d515b79a0a74f5e6aac33d5fe02c2d5770
+        sourceRevisionDigest: sha256:8fbad8b5c23a2fe3e93b217eb53ad7553bfe65258b1290561f6dd032902cdd43
+        sourceBlobDigest: sha256:675ba84c245ed56b7b1b5b2bd89af6529a8c9018f62f9f329f41d53ce0eb1049
         tags:
             - latest
-            - speakeasy-sdk-regen-1742563389
-            - v3.0.3
+            - speakeasy-sdk-regen-1750254460
+            - v3.0.5
 targets:
     formance-sdk-php:
         source: stacks-source
         sourceNamespace: stacks-source
-        sourceRevisionDigest: sha256:7cb558a099e645b1d753a57048c9154429c99e3a7e971567881ab9d26e478f67
-        sourceBlobDigest: sha256:f425dd02ba31efb8d82cd4e74907e8d515b79a0a74f5e6aac33d5fe02c2d5770
+        sourceRevisionDigest: sha256:8fbad8b5c23a2fe3e93b217eb53ad7553bfe65258b1290561f6dd032902cdd43
+        sourceBlobDigest: sha256:675ba84c245ed56b7b1b5b2bd89af6529a8c9018f62f9f329f41d53ce0eb1049
         codeSamplesNamespace: stacks-source-php-code-samples
-        codeSamplesRevisionDigest: sha256:7661587bb98eabf7833b72620b146a8978613d8a935b755d78555ad4092741cc
+        codeSamplesRevisionDigest: sha256:a83bbc634c73bb1ad00b49c79f1ab227713dae945aea00e9814b5cc90fddba1f
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: latest

.speakeasy/workflow.lock

@@ -188,7 +188,6 @@ if ($response->getVersionsResponse !== null) {
 
 #### [ledger->v2](docs/sdks/v2/README.md)
 
-* [getMetrics](docs/sdks/v2/README.md#getmetrics) - Read in memory metrics
 * [addMetadataOnTransaction](docs/sdks/v2/README.md#addmetadataontransaction) - Set the metadata of a transaction by its ID
 * [addMetadataToAccount](docs/sdks/v2/README.md#addmetadatatoaccount) - Add metadata to an account
 * [countAccounts](docs/sdks/v2/README.md#countaccounts) - Count the accounts from a ledger
@@ -205,6 +204,7 @@ if ($response->getVersionsResponse !== null) {
 * [getInfo](docs/sdks/v2/README.md#getinfo) - Show server information
 * [getLedger](docs/sdks/v2/README.md#getledger) - Get a ledger
 * [getLedgerInfo](docs/sdks/v2/README.md#getledgerinfo) - Get information about a ledger
+* [getMetrics](docs/sdks/v2/README.md#getmetrics) - Read in memory metrics
 * [getTransaction](docs/sdks/v2/README.md#gettransaction) - Get transaction from a ledger by its ID
 * [getVolumesWithBalances](docs/sdks/v2/README.md#getvolumeswithbalances) - Get list of volumes with balances for (account/asset)
 * [importLogs](docs/sdks/v2/README.md#importlogs)
@@ -241,7 +241,6 @@ if ($response->getVersionsResponse !== null) {
 
 #### [orchestration->v2](docs/sdks/sdkv2/README.md)
 
-* [testTrigger](docs/sdks/sdkv2/README.md#testtrigger) - Test trigger
 * [cancelEvent](docs/sdks/sdkv2/README.md#cancelevent) - Cancel a running workflow
 * [createTrigger](docs/sdks/sdkv2/README.md#createtrigger) - Create trigger
 * [createWorkflow](docs/sdks/sdkv2/README.md#createworkflow) - Create workflow
@@ -259,6 +258,7 @@ if ($response->getVersionsResponse !== null) {
 * [readTrigger](docs/sdks/sdkv2/README.md#readtrigger) - Read trigger
 * [runWorkflow](docs/sdks/sdkv2/README.md#runworkflow) - Run workflow
 * [sendEvent](docs/sdks/sdkv2/README.md#sendevent) - Send an event to a running workflow
+* [testTrigger](docs/sdks/sdkv2/README.md#testtrigger) - Test trigger
 
 ### [payments](docs/sdks/payments/README.md)
 
@@ -281,7 +281,8 @@ if ($response->getVersionsResponse !== null) {
 * [getConnectorTaskV1](docs/sdks/sdkpaymentsv1/README.md#getconnectortaskv1) - Read a specific task of the connector
 * [getPayment](docs/sdks/sdkpaymentsv1/README.md#getpayment) - Get a payment
 * [getPool](docs/sdks/sdkpaymentsv1/README.md#getpool) - Get a Pool
-* [getPoolBalances](docs/sdks/sdkpaymentsv1/README.md#getpoolbalances) - Get pool balances
+* [getPoolBalances](docs/sdks/sdkpaymentsv1/README.md#getpoolbalances) - Get historical pool balances at a particular point in time
+* [getPoolBalancesLatest](docs/sdks/sdkpaymentsv1/README.md#getpoolbalanceslatest) - Get latest pool balances
 * [getTransferInitiation](docs/sdks/sdkpaymentsv1/README.md#gettransferinitiation) - Get a transfer initiation
 * [installConnector](docs/sdks/sdkpaymentsv1/README.md#installconnector) - Install a connector
 * [listAllConnectors](docs/sdks/sdkpaymentsv1/README.md#listallconnectors) - List all installed connectors
@@ -302,36 +303,41 @@ if ($response->getVersionsResponse !== null) {
 * [resetConnectorV1](docs/sdks/sdkpaymentsv1/README.md#resetconnectorv1) - Reset a connector
 * [retryTransferInitiation](docs/sdks/sdkpaymentsv1/README.md#retrytransferinitiation) - Retry a failed transfer initiation
 * [reverseTransferInitiation](docs/sdks/sdkpaymentsv1/README.md#reversetransferinitiation) - Reverse a transfer initiation
-* [udpateTransferInitiationStatus](docs/sdks/sdkpaymentsv1/README.md#udpatetransferinitiationstatus) - Update the status of a transfer initiation
 * [~~uninstallConnector~~](docs/sdks/sdkpaymentsv1/README.md#uninstallconnector) - Uninstall a connector :warning: **Deprecated**
 * [uninstallConnectorV1](docs/sdks/sdkpaymentsv1/README.md#uninstallconnectorv1) - Uninstall a connector
 * [updateBankAccountMetadata](docs/sdks/sdkpaymentsv1/README.md#updatebankaccountmetadata) - Update metadata of a bank account
 * [updateConnectorConfigV1](docs/sdks/sdkpaymentsv1/README.md#updateconnectorconfigv1) - Update the config of a connector
 * [updateMetadata](docs/sdks/sdkpaymentsv1/README.md#updatemetadata) - Update metadata
+* [updateTransferInitiationStatus](docs/sdks/sdkpaymentsv1/README.md#updatetransferinitiationstatus) - Update the status of a transfer initiation
 
 #### [payments->v3](docs/sdks/v3/README.md)
 
 * [addAccountToPool](docs/sdks/v3/README.md#addaccounttopool) - Add an account to a pool
+* [addBankAccountToPaymentServiceUser](docs/sdks/v3/README.md#addbankaccounttopaymentserviceuser) - Add a bank account to a payment service user
 * [approvePaymentInitiation](docs/sdks/v3/README.md#approvepaymentinitiation) - Approve a payment initiation
 * [createAccount](docs/sdks/v3/README.md#createaccount) - Create a formance account object. This object will not be forwarded to the connector. It is only used for internal purposes.
 
 * [createBankAccount](docs/sdks/v3/README.md#createbankaccount) - Create a formance bank account object. This object will not be forwarded to the connector until you called the forwardBankAccount method.
 
 * [createPayment](docs/sdks/v3/README.md#createpayment) - Create a formance payment object. This object will not be forwarded to the connector. It is only used for internal purposes.
 
+* [createPaymentServiceUser](docs/sdks/v3/README.md#createpaymentserviceuser) - Create a formance payment service user object
 * [createPool](docs/sdks/v3/README.md#createpool) - Create a formance pool object
 * [deletePaymentInitiation](docs/sdks/v3/README.md#deletepaymentinitiation) - Delete a payment initiation by ID
 * [deletePool](docs/sdks/v3/README.md#deletepool) - Delete a pool by ID
 * [forwardBankAccount](docs/sdks/v3/README.md#forwardbankaccount) - Forward a Bank Account to a PSP for creation
+* [forwardPaymentServiceUserBankAccount](docs/sdks/v3/README.md#forwardpaymentserviceuserbankaccount) - Forward a payment service user's bank account to a connector
 * [getAccount](docs/sdks/v3/README.md#getaccount) - Get an account by ID
 * [getAccountBalances](docs/sdks/v3/README.md#getaccountbalances) - Get account balances
 * [getBankAccount](docs/sdks/v3/README.md#getbankaccount) - Get a Bank Account by ID
 * [getConnectorConfig](docs/sdks/v3/README.md#getconnectorconfig) - Get a connector configuration by ID
 * [getConnectorSchedule](docs/sdks/v3/README.md#getconnectorschedule) - Get a connector schedule by ID
 * [getPayment](docs/sdks/v3/README.md#getpayment) - Get a payment by ID
 * [getPaymentInitiation](docs/sdks/v3/README.md#getpaymentinitiation) - Get a payment initiation by ID
+* [getPaymentServiceUser](docs/sdks/v3/README.md#getpaymentserviceuser) - Get a payment service user by ID
 * [getPool](docs/sdks/v3/README.md#getpool) - Get a pool by ID
-* [getPoolBalances](docs/sdks/v3/README.md#getpoolbalances) - Get pool balances
+* [getPoolBalances](docs/sdks/v3/README.md#getpoolbalances) - Get historical pool balances from a particular point in time
+* [getPoolBalancesLatest](docs/sdks/v3/README.md#getpoolbalanceslatest) - Get latest pool balances
 * [getTask](docs/sdks/v3/README.md#gettask) - Get a task and its result by ID
 * [initiatePayment](docs/sdks/v3/README.md#initiatepayment) - Initiate a payment
 * [installConnector](docs/sdks/v3/README.md#installconnector) - Install a connector
@@ -344,6 +350,7 @@ if ($response->getVersionsResponse !== null) {
 * [listPaymentInitiationAdjustments](docs/sdks/v3/README.md#listpaymentinitiationadjustments) - List all payment initiation adjustments
 * [listPaymentInitiationRelatedPayments](docs/sdks/v3/README.md#listpaymentinitiationrelatedpayments) - List all payments related to a payment initiation
 * [listPaymentInitiations](docs/sdks/v3/README.md#listpaymentinitiations) - List all payment initiations
+* [listPaymentServiceUsers](docs/sdks/v3/README.md#listpaymentserviceusers) - List all payment service users
 * [listPayments](docs/sdks/v3/README.md#listpayments) - List all payments
 * [listPools](docs/sdks/v3/README.md#listpools) - List all pools
 * [rejectPaymentInitiation](docs/sdks/v3/README.md#rejectpaymentinitiation) - Reject a payment initiation
@@ -354,6 +361,7 @@ if ($response->getVersionsResponse !== null) {
 * [uninstallConnector](docs/sdks/v3/README.md#uninstallconnector) - Uninstall a connector
 * [updateBankAccountMetadata](docs/sdks/v3/README.md#updatebankaccountmetadata) - Update a bank account's metadata
 * [updatePaymentMetadata](docs/sdks/v3/README.md#updatepaymentmetadata) - Update a payment's metadata
+* [v3UpdateConnectorConfig](docs/sdks/v3/README.md#v3updateconnectorconfig) - Update the config of a connector
 
 ### [reconciliation](docs/sdks/reconciliation/README.md)
 
@@ -434,7 +442,7 @@ By default an API error will raise a `Errors\SDKException` exception, which has
 | `$rawResponse` | *?\Psr\Http\Message\ResponseInterface*  | The raw HTTP response |
 | `$body`        | *string*                                | The response content  |
 
-When custom error responses are specified for an operation, the SDK may also throw their associated exception. You can refer to respective *Errors* tables in SDK docs for more details on possible exception types for each operation. For example, the `getMetrics` method throws the following exceptions:
+When custom error responses are specified for an operation, the SDK may also throw their associated exception. You can refer to respective *Errors* tables in SDK docs for more details on possible exception types for each operation. For example, the `addMetadataOnTransaction` method throws the following exceptions:
 
 | Error Type             | Status Code | Content Type     |
 | ---------------------- | ----------- | ---------------- |
@@ -448,8 +456,10 @@ declare(strict_types=1);
 
 require 'vendor/autoload.php';
 
+use Brick\Math\BigInteger;
 use formance\stack;
 use formance\stack\Models\Errors;
+use formance\stack\Models\Operations;
 use formance\stack\Models\Shared;
 
 $sdk = stack\SDK::builder()
@@ -462,11 +472,20 @@ $sdk = stack\SDK::builder()
     ->build();
 
 try {
-    $response = $sdk->ledger->v2->getMetrics(
+    $request = new Operations\V2AddMetadataOnTransactionRequest(
+        requestBody: [
+            'admin' => 'true',
+        ],
+        dryRun: true,
+        id: BigInteger::of('1234'),
+        ledger: 'ledger001',
+    );
 
+    $response = $sdk->ledger->v2->addMetadataOnTransaction(
+        request: $request
     );
 
-    if ($response->object !== null) {
+    if ($response->statusCode === 200) {
         // handle response
     }
 } catch (Errors\V2ErrorResponseThrowable $e) {
@@ -543,7 +562,7 @@ use formance\stack;
 use formance\stack\Models\Shared;
 
 $sdk = stack\SDK::builder()
-    ->setServerURL('http://localhost')
+    ->setServerURL('https://orgID-stackID.eu.sandbox.formance.cloud')
     ->setSecurity(
         new Shared\Security(
             clientID: '<YOUR_CLIENT_ID_HERE>',

README.md

@@ -298,4 +298,14 @@ Based on:
 ### Generated
 - [php v4.1.1] .
 ### Releases
-- [Composer v4.1.1] https://packagist.org/packages/formance/formance-sdk#v4.1.1 - .
+- [Composer v4.1.1] https://packagist.org/packages/formance/formance-sdk#v4.1.1 - .
+
+## 2025-06-18 13:47:23
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.565.0 (2.630.9) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [php v4.2.0] .
+### Releases
+- [Composer v4.2.0] https://packagist.org/packages/formance/formance-sdk#v4.2.0 - .

RELEASES.md

@@ -17,7 +17,7 @@
     "brick/math": "^0.12.1"
   },
   "require-dev": {
-    "laravel/pint": "^1.18.1",
+    "laravel/pint": "^1.21.2",
     "phpstan/phpstan": "^2.1.0",
     "phpunit/phpunit": "^10",
     "roave/security-advisories": "dev-latest"

composer.json

@@ -5,6 +5,6 @@
 
 | Field                                                                                        | Type                                                                                         | Required                                                                                     | Description                                                                                  | Example                                                                                      |
 | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
+| `details`                                                                                    | *?string*                                                                                    | :heavy_minus_sign:                                                                           | N/A                                                                                          | https://play.numscript.org/?payload=eyJlcnJvciI6ImFjY291bnQgaGFkIGluc3VmZmljaWVudCBmdW5kcyJ9 |
 | `errorCode`                                                                                  | [Shared\ErrorsEnum](../../Models/Shared/ErrorsEnum.md)                                       | :heavy_check_mark:                                                                           | N/A                                                                                          | INSUFFICIENT_FUND                                                                            |
-| `errorMessage`                                                                               | *string*                                                                                     | :heavy_check_mark:                                                                           | N/A                                                                                          | [INSUFFICIENT_FUND] account had insufficient funds                                           |
-| `details`                                                                                    | *?string*                                                                                    | :heavy_minus_sign:                                                                           | N/A                                                                                          | https://play.numscript.org/?payload=eyJlcnJvciI6ImFjY291bnQgaGFkIGluc3VmZmljaWVudCBmdW5kcyJ9 |
+| `errorMessage`                                                                               | *string*                                                                                     | :heavy_check_mark:                                                                           | N/A                                                                                          | [INSUFFICIENT_FUND] account had insufficient funds                                           |

docs/Models/Errors/ErrorResponse.md

@@ -7,6 +7,6 @@ Error response
 
 | Field              | Type               | Required           | Description        | Example            |
 | ------------------ | ------------------ | ------------------ | ------------------ | ------------------ |
+| `details`          | *?string*          | :heavy_minus_sign: | N/A                |                    |
 | `errorCode`        | *string*           | :heavy_check_mark: | N/A                | VALIDATION         |
-| `errorMessage`     | *string*           | :heavy_check_mark: | N/A                |                    |
-| `details`          | *?string*          | :heavy_minus_sign: | N/A                |                    |
+| `errorMessage`     | *string*           | :heavy_check_mark: | N/A                |                    |