Stellar Anchor Platform

https://github.com/stellar/anchor-platform
Admin
The Stellar Anchor Platform is a service that provides the easiest and fastest way to deploy...
Tokens:9,770
Snippets:162
Trust Score:9.4
License:Apache-2.0
Update:4 months ago
Show doc for...
Tokens:
Raw
### Start Minikube

Source: https://github.com/stellar/anchor-platform/blob/develop/helm-charts/README.md

Start a local Kubernetes cluster using Minikube.

```bash
minikube start
```

--------------------------------

### Example Docker Version Output

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/A - Development Environment.md

An example of the expected output when checking the Docker version.

```shell
Docker version 23.0.5, build bc4487a
```

--------------------------------

### Start All Anchor Platform Servers

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/A - Development Environment.md

Start all necessary servers for the Anchor Platform development environment using Gradle.

```shell
./gradlew startAllServers
```

--------------------------------

### Install Reference Business Server

Source: https://github.com/stellar/anchor-platform/blob/develop/helm-charts/README.md

Install the reference business server using Helm, specifying the chart path and values file.

```bash
helm upgrade --install reference-server ./reference-server/ -f ./reference-server/values.yaml
```

--------------------------------

### Install PostgreSQL and PostgreSQL-Ref

Source: https://github.com/stellar/anchor-platform/blob/develop/helm-charts/README.md

Add the Bitnami Helm repository, update repositories, and install both postgresql and postgresql-ref charts with a specified password.

```bash
helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update
helm install postgresql-ref bitnami/postgresql --version 15.1.2 --set global.postgresql.auth.postgresPassword=123456789
helm install postgresql bitnami/postgresql --version 15.1.2 --set global.postgresql.auth.postgresPassword=123456789
```

--------------------------------

### Start Docker Compose Services

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/A - Development Environment.md

Start Kafka, Postgres, and SEP24 Reference UI using Docker Compose via Gradle.

```shell
./gradlew dockerComposeStart
```

--------------------------------

### Create .env File from Example

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/A - Development Environment.md

Copy the example environment file to create your local .env file, which holds secrets and configurations for running the Anchor Platform.

```shell
cp .env.example .env
```

--------------------------------

### Install SEP-24 Reference UI

Source: https://github.com/stellar/anchor-platform/blob/develop/helm-charts/README.md

Installs the SEP-24 Reference UI using Helm. Ensure you are in the correct directory before running.

```bash
helm upgrade --install sep24-reference-ui ./sep24-reference-ui/ -f ./sep24-reference-ui/values.yaml
```

--------------------------------

### Install Kafka

Source: https://github.com/stellar/anchor-platform/blob/develop/helm-charts/README.md

Create a Kubernetes secret for Kafka credentials and then install the Kafka Helm chart using the created secret.

```bash
kubectl create secret generic ap-kafka-secrets --from-literal=client-passwords=123456789 --from-literal=controller-password=123456789 --from-literal=inter-broker-password=123456789 --from-literal=system-user-password=123456789
helm install kafka bitnami/kafka --version 27.1.2 --set sasl.existingSecret=ap-kafka-secrets
```

--------------------------------

### Install Nginx Ingress Controller

Source: https://github.com/stellar/anchor-platform/blob/develop/helm-charts/README.md

Installs the nginx-ingress-controller into the 'ingress-nginx' namespace. This command should only be run once.

```bash
helm upgrade --install ingress-nginx ingress-nginx \
  --repo https://kubernetes.github.io/ingress-nginx \
  --namespace ingress-nginx --create-namespace
```

--------------------------------

### Check Java Installation

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/A - Development Environment.md

Verify if JDK 17 is installed on your system.

```shell
java -version
```

--------------------------------

### Install Anchor Platform Services

Source: https://github.com/stellar/anchor-platform/blob/develop/helm-charts/README.md

Install the Anchor Platform services, including sep-server, platform-server, event-processor, and observer, using Helm.

```bash
helm upgrade --install anchor-platform ./sep-service/ -f ./sep-service/values.yaml
```

--------------------------------

### Expected Secret Store Output

Source: https://github.com/stellar/anchor-platform/blob/develop/helm-charts/README.md

Example output showing the secrets available in the Kubernetes cluster after installation.

```text
NAME                                      TYPE                 DATA   AGE
ap-kafka-secrets                          Opaque               4      9m37s
kafka-kraft-cluster-id                    Opaque               1      9m35s
postgresql                                Opaque               1      10m
postgresql-ref                            Opaque               1      10m
sh.helm.release.v1.fake-secret-store.v1   helm.sh/release.v1   1      4m11s
sh.helm.release.v1.fake-secret-store.v2   helm.sh/release.v1   1      18s
sh.helm.release.v1.kafka.v1               helm.sh/release.v1   1      9m35s
sh.helm.release.v1.postgresql-ref.v1      helm.sh/release.v1   1      10m
sh.helm.release.v1.postgresql.v1          helm.sh/release.v1   1      10m
```

--------------------------------

### Check Docker Installation

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/A - Development Environment.md

Verify if Docker is installed and check its version. Docker version 23.0.0 or higher is recommended.

```shell
docker --version
```

--------------------------------

### Install Fake Secret Store

Source: https://github.com/stellar/anchor-platform/blob/develop/helm-charts/README.md

Source environment variables and then install or upgrade the fake-secret-store Helm chart using provided secrets.

```bash
source ../.env
helm upgrade --install fake-secret-store ./secret-store/ --set sep10_signing_seed=$SECRET_SEP10_SIGNING_SEED --set sentry_auth_token=$SENTRY_AUTH_TOKEN --set payment_signing_seed=$APP__PAYMENT_SIGNING_SEED
```

--------------------------------

### Run Anchor Platform (v2.x.x Stable)

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/README.md

Starts the Anchor Platform using Docker Compose for the v2.x.x stable release. Ensure you are in the root directory of the project.

```shell
# In the root directory of the project
docker compose --profile v2-stable up -d
```

--------------------------------

### Check Secret Store Status

Source: https://github.com/stellar/anchor-platform/blob/develop/helm-charts/README.md

Get all Kubernetes secrets to verify the status of installed components, including the fake-secret-store.

```bash
kubectl get secrets
```

--------------------------------

### Install Git Hooks for Code Formatting

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/A - Development Environment.md

Install Git hooks to automatically format code using Google Java Format and ktfmt before each commit.

```shell
./gradlew updateGitHook
```

--------------------------------

### Install External Secrets Helm Repository

Source: https://github.com/stellar/anchor-platform/blob/develop/helm-charts/README.md

Add the external-secrets Helm repository, update repositories, and install the external-secrets chart.

```bash
helm repo add external-secrets https://charts.external-secrets.io
helm repo update
helm install external-secrets \
   external-secrets/external-secrets \
    -n external-secrets \
    --create-namespace
```

--------------------------------

### Run Anchor Platform (Latest Release)

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/README.md

Starts the Anchor Platform using Docker Compose for the latest release. Ensure you are in the root directory of the project.

```shell
# In the root directory of the project
docker compose --profile latest up -d
```

--------------------------------

### Build and Deploy Account and Web Auth Contracts

Source: https://github.com/stellar/anchor-platform/blob/develop/soroban/README.md

Builds the contracts and deploys both the account and web-auth contracts to the testnet. Ensure you have the Stellar CLI installed and configured.

```bash
# Build the contracts under ${PROJECT_DIR}/soroban directory.
stellar contract build

# Deploy the account contract
stellar contract deploy \
--wasm target/wasm32v1-none/release/account.wasm \
--source-account ${MY_ACCOUNT} \
--network testnet \
--salt 616e63686f722d706c6174666f726d \
-- \
--admin ${MY_ACCOUNT} \
--signer ${MY_ACCOUNT_PUBLIC_KEY_BYTES} # you can get this by calling KeyPair#rawPublicKey using the JS SDK

# Deploy the web auth contract
stellar contract deploy \
--wasm target/wasm32v1-none/release/web_auth.wasm \
--source-account ${MY_ACCOUNT} \
--network testnet \
--salt 616e63686f722d706c6174666f726d \
-- \
--admin ${MY_ACCOUNT}
```

--------------------------------

### Run Anchor Platform (Locally Built Image)

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/README.md

Starts the Anchor Platform using Docker Compose with a locally built Docker image. Ensure you are in the root directory of the project.

```shell
# In the root directory of the project
docker compose --profile local up -d
```

--------------------------------

### Run Anchor Platform with Docker Compose

Source: https://github.com/stellar/anchor-platform/blob/develop/README.md

Starts all necessary services for the Anchor Platform locally using Docker Compose. Ensure you are in the 'quick-run' directory before executing.

```shell
cd quick-run
docker-compose up -d
```

--------------------------------

### Start Servers with Specific Test Profile

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/A - Development Environment.md

Start the Anchor Platform servers using a specific test profile by setting the TEST_PROFILE_NAME environment variable.

```shell
export TEST_PROFILE_NAME=default && ./gradlew startServersWithTestProfile
```

--------------------------------

### Run Servers with Host Docker Internal Profile

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/A - Development Environment.md

Starts the servers using the `host-docker-internal` test profile. This can also be run from IntelliJ.

```bash
export TEST_PROFILE_NAME=host-docker-internal && ./gradlew startServersWithTestProfile
```

--------------------------------

### Run Essential Tests

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/A - Development Environment.md

Execute essential tests after starting Docker Compose and all servers.

```shell
./gradlew runEssentialTests
```

--------------------------------

### Clone Stellar Anchor Platform Repository

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/A - Development Environment.md

Use this command to clone the project repository from GitHub. Ensure you have Git installed and configured.

```shell
git clone git@github.com:stellar/anchor-platform.git
```

--------------------------------

### Verify Anchor Platform is Running

Source: https://github.com/stellar/anchor-platform/blob/develop/README.md

Checks if the Anchor Platform is accessible by making a request to its .well-known/stellar.toml endpoint. This confirms that the platform services have started correctly.

```shell
curl http://localhost:8080/.well-known/stellar.toml
```

--------------------------------

### Stop Anchor Platform Services

Source: https://github.com/stellar/anchor-platform/blob/develop/README.md

Shuts down all services that were started by Docker Compose. This command should be run from the 'quick-run' directory.

```shell
docker-compose down
```

--------------------------------

### Example Git Commit Message

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/B - Git Guidelines.md

Follow the imperative mood for commit messages. Include a concise subject line, followed by a blank line, and then a more detailed explanation if necessary. References to issues can be added at the end.

```text
Fix issue where Foo is handled as Bar.

Further paragraphs come after blank lines.

- Bullet points are okay, too
- Typically a hyphen or asterisk is used for the bullet, and bullets are wrapped by spaces before and after each bullet block.

If the commit relates to an issue, add a reference(s) to them at the bottom, like so:

Resolve: #123
```

--------------------------------

### Terraform User Policy Example

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/resources/deployment-examples/example-fargate/readme.md

This is a placeholder for the AWS IAM policy required for the Terraform deployment user. Replace '[TODO replace deployment aws policy]' with the actual policy.

```plaintext
[TODO replace deployment aws policy]
```

--------------------------------

### Build All Projects with Gradle

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/A - Development Environment.md

Use the Gradle wrapper to build all projects in the Anchor Platform.

```shell
./gradlew build
```

--------------------------------

### Run All Unit Tests with Gradle

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/A - Development Environment.md

Execute all unit tests for the Anchor Platform using the Gradle wrapper.

```shell
./gradlew test
```

--------------------------------

### Build Anchor Platform Docker Image

Source: https://github.com/stellar/anchor-platform/blob/develop/helm-charts/README.md

Build the Anchor Platform Docker image locally and tag it as 'anchor-platform:local'.

```bash
docker build -t anchor-platform:local ../
```

--------------------------------

### Publish SDK with Gradle

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/F - Publishing the SDK.md

Set environment variables for Nexus Repository credentials and run the Gradle publish task to sign and publish artifacts.

```shell
./gradlew publish
```

--------------------------------

### Enable Minikube Docker Environment

Source: https://github.com/stellar/anchor-platform/blob/develop/helm-charts/README.md

Evaluate the output of `minikube docker-env` to make the built Docker image available to the Kubernetes cluster.

```bash
eval $(minikube -p minikube docker-env)
```

--------------------------------

### Build Anchor Platform Local Docker Image

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/README.md

Builds a local Docker image for the Anchor Platform. Run this command in the root directory of the project.

```shell
# In the root directory of the project
docker build -t stellar/anchor-platform:local .
```

--------------------------------

### Check Docker Images in Minikube

Source: https://github.com/stellar/anchor-platform/blob/develop/helm-charts/README.md

Verify that the Anchor Platform image was built successfully and is available in the Minikube Docker registry.

```bash
minikube ssh -- docker images
```

--------------------------------

### List GPG Keys

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/F - Publishing the SDK.md

Commands to list GPG keys. Use `--keyid-format short` for a concise output of key IDs.

```shell
gpg2 --list-keys
```

```shell
gpg2 --list-keys --keyid-format short
```

--------------------------------

### Clone Anchor Platform Repository

Source: https://github.com/stellar/anchor-platform/blob/develop/helm-charts/README.md

Clone the Anchor Platform repository and navigate to the helm-charts directory.

```bash
git clone git@github.com:stellar/anchor-platform.git

# Change to the helm-charts directory
cd anchor-platform/helm-charts
```

--------------------------------

### Port Forward Reference Business Server

Source: https://github.com/stellar/anchor-platform/blob/develop/helm-charts/README.md

Sets up port forwarding for the reference business server to facilitate debugging. Runs in the background.

```bash
kubectl port-forward svc/reference-server-svc-reference-server 8091:8091 -n default &
```

--------------------------------

### Configure Hosts File for Docker Communication

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/A - Development Environment.md

Add these entries to your /etc/hosts (macOS/Linux) or C:\\Windows\\System32\\Drivers\\etc\\hosts (Windows) file. This is necessary for integration and end-to-end tests to function correctly with Docker containers.

```shell
127.0.0.1 db
127.0.0.1 kafka
127.0.0.1 sep24-reference-ui
127.0.0.1 reference-server
127.0.0.1 reference-db
127.0.0.1 wallet-server
127.0.0.1 platform
127.0.0.1 host.docker.internal
```

--------------------------------

### Configure Gradle Signing Properties

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/F - Publishing the SDK.md

Add these entries to `~/.gradle/gradle.properties` to configure Gradle for signing publications using your GPG key.

```properties
signing.keyId=${short-key-id}
signing.password=${key-password}
signing.secretKeyRingFile=${HOME_DIR}/.gnupg/secring.gpg
```

--------------------------------

### Run Subproject Unit Tests with Gradle

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/A - Development Environment.md

Execute unit tests for a specific subproject using the Gradle wrapper.

```shell
./gradlew :[subproject]:test
```

--------------------------------

### Build Specific Subproject with Gradle

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/A - Development Environment.md

Build a specific subproject within the Anchor Platform using the Gradle wrapper.

```shell
./gradlew :[subproject]:build
```

--------------------------------

### Set TEST_HOME_DOMAIN Environment Variable

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/A - Development Environment.md

Configures the home domain for anchor tests. The default is `http://host.docker.internal:8080`.

```bash
export TEST_HOME_DOMAIN=http://{server}:{port}
```

--------------------------------

### Port Forward SEP-24 Reference UI

Source: https://github.com/stellar/anchor-platform/blob/develop/helm-charts/README.md

Configures port forwarding for the SEP-24 Reference UI, enabling debugging. Runs in the background.

```bash
kubectl port-forward svc/sep24-reference-ui-svc-sep24-reference-ui 3000:3000 -n default &
```

--------------------------------

### List Kubernetes Services

Source: https://github.com/stellar/anchor-platform/blob/develop/helm-charts/README.md

Displays a list of all services running in the Kubernetes cluster, including their cluster IP and ports.

```bash
kubectl get services
```

--------------------------------

### Clone Anchor Platform Project

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/A - Development Environment.md

Clone the Anchor Platform project repository from GitHub.

```shell
git clone git@github.com:stellar/anchor-platform.git
```

```shell
git clone https://github.com/stellar/anchor-platform.git
```

--------------------------------

### Port Forward Ingress Controller

Source: https://github.com/stellar/anchor-platform/blob/develop/helm-charts/README.md

Sets up port forwarding for the ingress controller to allow debugging. Runs in the background.

```bash
kubectl port-forward svc/ingress-nginx-controller 8080:80 -n ingress-nginx &
```

--------------------------------

### Build Spring Boot Application JAR

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/A - Development Environment.md

Generate the Spring Boot application JAR file using the Gradle wrapper.

```shell
./gradlew bootJar
```

--------------------------------

### Stop Docker Compose Services

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/A - Development Environment.md

Stop Kafka, Postgres, and SEP24 Reference UI using Docker Compose via Gradle.

```shell
./gradlew dockerComposeStop
```

--------------------------------

### Run Extended Tests

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/A - Development Environment.md

Executes the extended tests for the platform, specifically targeting the End2EndTestSuite.

```bash
./gradlew :extended-tests:test --tests org.stellar.anchor.platform.suite.End2EndTestSuite
```

--------------------------------

### Set TEST_SEPS Environment Variable

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/A - Development Environment.md

Specifies which SEPs (Stellar Ecosystem Proposals) to test. The default value is `1,10,12,24,31,38`.

```bash
export TEST_SEPS=1,10,24
```

--------------------------------

### Upgrade Account Contract

Source: https://github.com/stellar/anchor-platform/blob/develop/soroban/README.md

Upgrades the account contract by first uploading the new WASM and then invoking the upgrade function with the new WASM hash. Requires the contract ID and the new WASM hash.

```bash
# Install the account wasm on the network
stellar contract upload \
--source ${MY_ACCOUNT} \
--wasm target/wasm32v1-none/release/account.wasm \
--network testnet

# Update the account contract with the new Wasm
stellar contract invoke \
  --id ${CONTRACT_ID} \
  --source ${MY_ACCOUNT} \
  --network testnet \
  -- \
  upgrade \
  --new_wasm_hash ${NEW_WASM_HASH}
```

--------------------------------

### Generate GPG Key Pair

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/F - Publishing the SDK.md

Use this command to generate a new GPG key pair. Select option 4 for a sign-only RSA key and 4096 bits for key strength.

```shell
> gpg2 --full-generate-key

Please select what kind of key you want:
   (1) RSA and RSA (default)
   (2) DSA and Elgamal
   (3) DSA (sign only)
   (4) RSA (sign only)
  (14) Existing key from card

Your Selection: 4
```

--------------------------------

### Export GPG Private Key

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/F - Publishing the SDK.md

Export your secret GPG key to a file named `secring.gpg` in the `~/.gnupg/` directory.

```shell
gpg --keyring secring.gpg --export-secret-keys > ~/.gnupg/secring.gpg
```

--------------------------------

### Upgrade Web-Auth Contract

Source: https://github.com/stellar/anchor-platform/blob/develop/soroban/README.md

Upgrades the web-auth contract by first uploading the new WASM and then invoking the upgrade function with the new WASM hash. Requires the contract ID and the new WASM hash.

```bash
# Install the account wasm on the network
stellar contract upload \
--source ${MY_ACCOUNT} \
--wasm target/wasm32v1-none/release/web_auth.wasm \
--network testnet

# Update the account contract with the new Wasm
stellar contract invoke \
  --id ${CONTRACT_ID} \
  --source ${MY_ACCOUNT} \
  --network testnet \
  -- \
  upgrade \
  --new_wasm_hash ${NEW_WASM_HASH}
```

--------------------------------

### Gradle Kotlin Dependency Declaration

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/F - Publishing the SDK.md

Add this line to your `build.gradle.kts` file (Kotlin) to include the Stellar Anchor Java SDK.

```kotlin
implementation("org.stellar.anchor-sdk:core:${version}")
```

--------------------------------

### Gradle Groovy Dependency Declaration

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/F - Publishing the SDK.md

Add this line to your `build.gradle` file (Groovy) to include the Stellar Anchor Java SDK.

```groovy
implementation group: 'org.stellar.anchor-sdk', name: 'core', version: '${version}'
```

--------------------------------

### SEP-6 Deposit Flow Diagram

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/diagrams/sep6/deposit.md

Visual representation of the asynchronous deposit flow between various participants including Wallet, Platform, Anchor, Bank, User, and Stellar.

```mermaid
sequenceDiagram
  participant Bank
  participant User
  participant Wallet
  participant Platform
  participant Stellar
  participant Anchor

  Wallet->>+Platform: GET /deposit
  Platform->>Platform: Creates deposit transaction with id abcd-1234 with status incomplete
  Platform-->>-Wallet: Returns deposit response with id abcd-1234 and deposit instructions omitted
  Platform-)Anchor: Sends an event callback with type transaction_created and transaction id abcd-1234
  loop until status is pending_user_transfer_start
    Anchor->>Anchor: Evaluates whether additional KYC is required
    alt requires additional KYC
      Anchor->>+Platform: PATCH /transaction abcd-1234 with status pending_customer_info_update and required_customer_info_updates fields
      Platform-->>-Anchor: Returns success response
      Platform-)Wallet: Sends an event callback with type transaction_status_changed
      Wallet->>User: Prompts user to update customer fields
      Wallet->>+Platform: PUT [SEP-12]/customer to provide updated customer fields
      Platform-->>-Wallet: Returns success response
      Platform-)Anchor: Sends an event callback with type customer_updated
    else no additional KYC required
      Anchor->>+Platform: PATCH /transaction abcd-1234 with status pending_user_transfer_start and deposit instructions
      Platform-->>-Anchor: Returns success response
    end
  end
  Platform-)Wallet: Sends an event callback with type transaction_status_changed and deposit instructions
  Wallet->>User: Prompts user to send funds using deposit instructions
  User->>Bank: Sends off-chain funds to Anchor's bank account
  loop until funds received
    Anchor->>+Bank: Polls bank account for funds
    Bank-->>-Anchor: Returns whether funds were received
  end
  Anchor->>+Stellar: Submits payment transaction to the user's account
  Stellar-->>-Anchor: Returns success response
  Anchor->>+Platform: PATCH /transaction abcd-1234 with status completed
  Platform-->>-Anchor: Returns success response
  Platform-)Wallet: Sends an event callback with type transaction_status_changed
  Wallet->>User: Notifies user that deposit is complete

```

--------------------------------

### Grant RDS IAM Permissions

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/G - Testing with AWS Services.md

Execute these SQL queries in your Postgres database to create a user and grant it the necessary rds_iam permission for IAM authentication.

```text
CREATE USER anchorplatform1;
GRANT rds_iam TO anchorplatform1;
```

--------------------------------

### Port Forward SEP Server

Source: https://github.com/stellar/anchor-platform/blob/develop/helm-charts/README.md

Establishes port forwarding for the SEP server for debugging purposes. Runs in the background.

```bash
kubectl port-forward svc/anchor-platform-svc-sep 8080:8080 -n default &
```

--------------------------------

### Check Kubernetes Pod Status

Source: https://github.com/stellar/anchor-platform/blob/develop/helm-charts/README.md

Verifies the status of all running services within the Kubernetes cluster. Useful for confirming successful deployments.

```bash
kubectl get pods
```

--------------------------------

### Maven Dependency Declaration

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/F - Publishing the SDK.md

Include this dependency in your Maven project to use the Stellar Anchor Java SDK.

```xml
<dependency>
    <groupId>org.stellar.anchor-sdk</groupId>
    <artifactId>core</artifactId>
    <version>${version}</version>
</dependency>
```

--------------------------------

### Stop Docker Compose

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/A - Development Environment.md

Shuts down the Docker Compose stack, stopping all associated containers.

```bash
./gradlew dockerComposeDown
```

--------------------------------

### IAM Policy for MSK Kafka Access

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/G - Testing with AWS Services.md

This JSON policy allows all Kafka cluster actions for a specified cluster and region. Ensure the ARN correctly identifies your MSK cluster and region.

```json
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "kafka-cluster:*"
            ],
            "Resource": [
                "arn:aws:kafka:us-east-1:760238374005:*/demo-cluster-1/*"
            ]
        }
    ]
}
```

--------------------------------

### Disable Automatic Flyway Migrations

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/D - Database Migration.md

To manually apply migrations, disable Flyway's automatic application on application startup by setting this property in your configuration.

```properties
spring.flyway.enabled: false
```

--------------------------------

### IAM Policy for RDS DB Connection

Source: https://github.com/stellar/anchor-platform/blob/develop/docs/01 - Contributing/G - Testing with AWS Services.md

This JSON policy grants the 'rds-db:connect' action for a specific database user on an Aurora Postgres instance. Replace the ARN with your database's Resource ID and the correct user.

```json
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "rds-db:connect"
            ],
            "Resource": [
                "arn:aws:rds-db:us-east-1:760238374005:dbuser:db-TY6R4WIFG2MTFWQAUCVOX5UQA4/anchorplatform1"
            ]
        }
    ]
}
```
Tokens:
Raw