├── .dockerignore
├── .env.example
├── .github
    ├── dependabot.yml
    └── workflows
    │   ├── release.yml
    │   └── test.yml
├── .gitignore
├── Dockerfile
├── LICENSE
├── Makefile
├── README.rst
├── data
    └── .gitignore
├── docker-compose.yml
├── docs
    ├── Makefile
    ├── api.rst
    ├── conf.py
    ├── custody.rst
    ├── deployment
    │   ├── process_pending_deposits_flow.png
    │   └── process_pending_deposits_submission_flow.png
    ├── glossary.rst
    ├── index.rst
    ├── installation.rst
    ├── rails.rst
    ├── requirements.txt
    ├── sep-1.rst
    ├── sep-10.rst
    ├── sep-12.rst
    ├── sep-24.rst
    ├── sep-31.rst
    ├── sep-38.rst
    └── sep-6.rst
├── example
    └── scripts
    │   └── get-circle-usdc.py
├── manage.py
├── poetry.lock
├── polaris
    ├── __init__.py
    ├── admin.py
    ├── apps.py
    ├── collectstatic
    │   └── __init__.py
    ├── cors.py
    ├── exceptions.py
    ├── integrations
    │   ├── __init__.py
    │   ├── custody.py
    │   ├── customers.py
    │   ├── fees.py
    │   ├── forms.py
    │   ├── info.py
    │   ├── quote.py
    │   ├── rails.py
    │   ├── sep31.py
    │   ├── toml.py
    │   └── transactions.py
    ├── locale
    │   ├── __init__.py
    │   ├── id
    │   │   └── LC_MESSAGES
    │   │   │   ├── django.mo
    │   │   │   └── django.po
    │   ├── pt
    │   │   └── LC_MESSAGES
    │   │   │   ├── django.mo
    │   │   │   └── django.po
    │   └── utils.py
    ├── management
    │   ├── __init__.py
    │   └── commands
    │   │   ├── __init__.py
    │   │   ├── execute_outgoing_transactions.py
    │   │   ├── poll_outgoing_transactions.py
    │   │   ├── process_pending_deposits.py
    │   │   ├── testnet.py
    │   │   └── watch_transactions.py
    ├── middleware.py
    ├── migrations
    │   ├── 0001_initial.py
    │   ├── 0002_auto_20200921_2135.py
    │   ├── 0003_auto_20201009_1300.py
    │   ├── 0004_auto_20201120_1541.py
    │   ├── 0005_auto_20210226_0053.py
    │   ├── 0006_transaction_more_info_url.py
    │   ├── 0007_transaction_on_change_callback.py
    │   ├── 0008_transaction_pending_execution_attempt.py
    │   ├── 0009_transaction_client_domain.py
    │   ├── 0010_auto_20210809_1605.py
    │   ├── 0011_transaction_amount_expected.py
    │   ├── 0012_auto_20210918_2053.py
    │   ├── 0013_auto_20211011_1956.py
    │   ├── 0014_auto_20220211_0624.py
    │   └── __init__.py
    ├── models.py
    ├── sep1
    │   ├── __init__.py
    │   ├── urls.py
    │   └── views.py
    ├── sep10
    │   ├── __init__.py
    │   ├── token.py
    │   ├── urls.py
    │   ├── utils.py
    │   └── views.py
    ├── sep12
    │   ├── __init__.py
    │   ├── customer.py
    │   └── urls.py
    ├── sep24
    │   ├── __init__.py
    │   ├── deposit.py
    │   ├── fee.py
    │   ├── info.py
    │   ├── transaction.py
    │   ├── tzinfo.py
    │   ├── urls.py
    │   ├── utils.py
    │   └── withdraw.py
    ├── sep31
    │   ├── __init__.py
    │   ├── info.py
    │   ├── serializers.py
    │   ├── transactions.py
    │   └── urls.py
    ├── sep38
    │   ├── __init__.py
    │   ├── info.py
    │   ├── prices.py
    │   ├── quote.py
    │   ├── serializers.py
    │   ├── urls.py
    │   └── utils.py
    ├── sep6
    │   ├── __init__.py
    │   ├── deposit.py
    │   ├── fee.py
    │   ├── info.py
    │   ├── transaction.py
    │   ├── urls.py
    │   ├── utils.py
    │   └── withdraw.py
    ├── settings.py
    ├── shared
    │   ├── __init__.py
    │   ├── endpoints.py
    │   └── serializers.py
    ├── static
    │   └── polaris
    │   │   ├── base.css
    │   │   ├── base.scss
    │   │   ├── chevron-down.svg
    │   │   ├── colors.scss
    │   │   ├── company-icon.svg
    │   │   ├── form-styles
    │   │       ├── file-picker.scss
    │   │       ├── forms.scss
    │   │       ├── select-list.scss
    │   │       ├── theme.scss
    │   │       └── toggle.scss
    │   │   ├── normalize.scss
    │   │   ├── progress.scss
    │   │   ├── reset.scss
    │   │   └── scripts
    │   │       ├── callback.js
    │   │       ├── disableSubmitOnClick.js
    │   │       ├── dynamicAmountPadding.js
    │   │       ├── feeTable.js
    │   │       ├── number.js
    │   │       ├── styleHelpers.js
    │   │       └── timezone.js
    ├── templates
    │   ├── __init__.py
    │   ├── django
    │   │   └── forms
    │   │   │   └── widgets
    │   │   │       ├── attrs.html
    │   │   │       ├── checkbox.html
    │   │   │       ├── checkbox_option.html
    │   │   │       ├── checkbox_select.html
    │   │   │       ├── clearable_file_input.html
    │   │   │       ├── date.html
    │   │   │       ├── datetime.html
    │   │   │       ├── email.html
    │   │   │       ├── file.html
    │   │   │       ├── hidden.html
    │   │   │       ├── input.html
    │   │   │       ├── input_option.html
    │   │   │       ├── multiple_hidden.html
    │   │   │       ├── multiple_input.html
    │   │   │       ├── multiwidget.html
    │   │   │       ├── number.html
    │   │   │       ├── password.html
    │   │   │       ├── radio.html
    │   │   │       ├── radio_option.html
    │   │   │       ├── select.html
    │   │   │       ├── select_date.html
    │   │   │       ├── select_option.html
    │   │   │       ├── splitdatetime.html
    │   │   │       ├── splithiddendatetime.html
    │   │   │       ├── text.html
    │   │   │       ├── textarea.html
    │   │   │       ├── time.html
    │   │   │       └── url.html
    │   └── polaris
    │   │   ├── base.html
    │   │   ├── deposit.html
    │   │   ├── error.html
    │   │   ├── more_info.html
    │   │   ├── widgets
    │   │       ├── card_cvv.html
    │   │       ├── card_expiration.html
    │   │       └── card_number.html
    │   │   └── withdraw.html
    ├── tests
    │   ├── __init__.py
    │   ├── auth_test.py
    │   ├── commands
    │   │   ├── __init__.py
    │   │   ├── test_poll_pending_deposits.py
    │   │   ├── test_testnet.py
    │   │   └── test_watch_transactions.py
    │   ├── conftest.py
    │   ├── helpers.py
    │   ├── sep1
    │   │   ├── __init__.py
    │   │   └── test_toml.py
    │   ├── sep10
    │   │   ├── __init__.py
    │   │   └── test_sep10.py
    │   ├── sep12
    │   │   ├── __init__.py
    │   │   └── test_customer.py
    │   ├── sep24
    │   │   ├── __init__.py
    │   │   ├── test_deposit.py
    │   │   ├── test_info.py
    │   │   ├── test_tzinfo.py
    │   │   └── test_withdraw.py
    │   ├── sep31
    │   │   ├── __init__.py
    │   │   ├── test_execute_outgoing_transactions.py
    │   │   ├── test_info.py
    │   │   ├── test_poll_outgoing_transactions.py
    │   │   ├── test_send.py
    │   │   ├── test_transaction.py
    │   │   └── test_update.py
    │   ├── sep38
    │   │   ├── __init__.py
    │   │   ├── test_info.py
    │   │   ├── test_price.py
    │   │   ├── test_prices.py
    │   │   └── test_quote.py
    │   ├── sep6
    │   │   ├── __init__.py
    │   │   ├── test_deposit.py
    │   │   ├── test_info.py
    │   │   ├── test_update.py
    │   │   └── test_withdraw.py
    │   ├── settings.py
    │   ├── shared_endpoints
    │   │   ├── __init__.py
    │   │   ├── test_fee.py
    │   │   ├── test_more_info.py
    │   │   ├── test_transaction.py
    │   │   └── test_transactions.py
    │   ├── test_register_integrations.py
    │   └── test_utils.py
    ├── urls.py
    └── utils.py
├── pyproject.toml
├── pytest.ini
├── readthedocs.yml
├── server
    ├── README.rst
    ├── __init__.py
    ├── admin.py
    ├── apps.py
    ├── collectstatic
    │   └── __init__.py
    ├── example-nginx.conf
    ├── forms.py
    ├── integrations
    │   ├── __init__.py
    │   ├── customers.py
    │   ├── deposit.py
    │   ├── fee.py
    │   ├── info.py
    │   ├── mock_banking_rails.py
    │   ├── mock_exchange.py
    │   ├── quotes.py
    │   ├── rails.py
    │   ├── sep24_kyc.py
    │   ├── sep31.py
    │   └── withdraw.py
    ├── locale
    │   ├── id
    │   │   └── LC_MESSAGES
    │   │   │   ├── django.mo
    │   │   │   └── django.po
    │   └── pt
    │   │   └── LC_MESSAGES
    │   │       ├── django.mo
    │   │       └── django.po
    ├── management
    │   ├── __init__.py
    │   └── commands
    │   │   ├── __init__.py
    │   │   └── sign_multisig_transactions.py
    ├── migrations
    │   ├── 0001_initial.py
    │   ├── 0002_auto_20200207_0002.py
    │   ├── 0003_auto_20200222_0003.py
    │   ├── 0004_auto_20200427_2302.py
    │   ├── 0005_auto_20200702_1908.py
    │   ├── 0006_auto_20200615_2046.py
    │   ├── 0007_auto_20210921_2005.py
    │   ├── 0008_offchainassetextra.py
    │   ├── 0009_auto_20211028_2139.py
    │   ├── 0010_auto_20230316_1120.py
    │   └── __init__.py
    ├── models.py
    ├── static
    │   ├── css
    │   │   └── transaction_confirmation.css
    │   ├── polaris
    │   │   ├── local-stellar.toml
    │   │   └── stellar.toml
    │   └── sep24_scripts
    │   │   ├── add_skip_confirmation_btn.js
    │   │   ├── check_email_confirmation.js
    │   │   └── google_analytics.js
    ├── templates
    │   ├── confirmation_email.html
    │   ├── email_confirmed.html
    │   ├── polaris
    │   │   ├── base.html
    │   │   └── more_info.html
    │   └── transaction_confirmation.html
    ├── urls.py
    ├── views.py
    └── wsgi.py
└── settings.py


/.dockerignore:
--------------------------------------------------------------------------------
  1 | .git
  2 | docs/build
  3 | 
  4 | # Byte-compiled / optimized / DLL files
  5 | __pycache__/
  6 | *.py[cod]
  7 | *$py.class
  8 | 
  9 | # C extensions
 10 | *.so
 11 | 
 12 | # Distribution / packaging
 13 | .Python
 14 | build/
 15 | develop-eggs/
 16 | dist/
 17 | downloads/
 18 | eggs/
 19 | .eggs/
 20 | lib/
 21 | lib64/
 22 | parts/
 23 | sdist/
 24 | var/
 25 | wheels/
 26 | pip-wheel-metadata/
 27 | share/python-wheels/
 28 | *.egg-info/
 29 | .installed.cfg
 30 | *.egg
 31 | MANIFEST
 32 | *.DS_Store
 33 | .vscode
 34 | .idea
 35 | 
 36 | # Static files
 37 | polaris/collectstatic/*
 38 | !polaris/collectstatic/__init__.py
 39 | server/collectstatic/*
 40 | !server/collectstatic/__init__.py
 41 | 
 42 | # Database
 43 | data/db.sqlite3
 44 | 
 45 | # PyInstaller
 46 | #  Usually these files are written by a python script from a template
 47 | #  before PyInstaller builds the exe, so as to inject date/other infos into it.
 48 | *.manifest
 49 | *.spec
 50 | 
 51 | # Installer logs
 52 | pip-log.txt
 53 | pip-delete-this-directory.txt
 54 | 
 55 | # Unit test / coverage reports
 56 | htmlcov/
 57 | .tox/
 58 | .nox/
 59 | .coverage
 60 | .coverage.*
 61 | .cache
 62 | nosetests.xml
 63 | coverage.xml
 64 | *.cover
 65 | .hypothesis/
 66 | .pytest_cache/
 67 | 
 68 | # Translations
 69 | *.pot
 70 | 
 71 | # Django stuff:
 72 | *.log
 73 | local_settings.py
 74 | db.sqlite3-journal
 75 | 
 76 | # Flask stuff:
 77 | instance/
 78 | .webassets-cache
 79 | 
 80 | # Scrapy stuff:
 81 | .scrapy
 82 | 
 83 | # Sphinx documentation
 84 | docs/_build/
 85 | 
 86 | # PyBuilder
 87 | target/
 88 | 
 89 | # Jupyter Notebook
 90 | .ipynb_checkpoints
 91 | 
 92 | # IPython
 93 | profile_default/
 94 | ipython_config.py
 95 | 
 96 | # pyenv
 97 | .python-version
 98 | 
 99 | # pipenv
100 | #   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
101 | #   However, in case of collaboration, if having platform-specific dependencies or dependencies
102 | #   having no cross-platform support, pipenv may install dependencies that don't work, or not
103 | #   install all needed dependencies.
104 | #Pipfile.lock
105 | 
106 | # SageMath parsed files
107 | *.sage.py
108 | 
109 | # Environments
110 | .env
111 | .venv
112 | env/
113 | venv/
114 | ENV/
115 | env.bak/
116 | venv.bak/
117 | 
118 | # Spyder project settings
119 | .spyderproject
120 | .spyproject
121 | 
122 | # Rope project settings
123 | .ropeproject
124 | 
125 | # mkdocs documentation
126 | /site
127 | 
128 | # mypy
129 | .mypy_cache/
130 | .dmypy.json
131 | dmypy.json
132 | 
133 | # Pyre type checker
134 | .pyre/
135 | 


--------------------------------------------------------------------------------
/.env.example:
--------------------------------------------------------------------------------
1 | DJANGO_SECRET_KEY="foo"
2 | SIGNING_SEED="SCY4F6VEIIPXPLTNQSFT5427H64YK3H3LB27H7WAOVDQSV2UACRWTPGM"
3 | SERVER_JWT_KEY="bar"
4 | HOST_URL="http://localhost:8000"
5 | LOCAL_MODE=1
6 | ACTIVE_SEPS="sep-1,sep-6,sep-10,sep-12,sep-24,sep-31,sep-38"
7 | 


--------------------------------------------------------------------------------
/.github/dependabot.yml:
--------------------------------------------------------------------------------
 1 | version: 2
 2 | updates:
 3 |   - package-ecosystem: "pip"
 4 |     directories: 
 5 |       - "/"
 6 |       - "/docs"
 7 |     schedule:
 8 |       interval: "weekly"
 9 |       day: "sunday"
10 |       time: "02:00"
11 |     open-pull-requests-limit: 2
12 |     groups:
13 |       minor-and-patch:
14 |         applies-to: version-updates
15 |         update-types:
16 |         - "patch"
17 |         - "minor"
18 |       major:
19 |         applies-to: version-updates
20 |         update-types:
21 |         - "major"
22 |   - package-ecosystem: "github-actions"
23 |     directory: "/"
24 |     schedule:
25 |       interval: "weekly"
26 |       day: "sunday"
27 |       time: "02:00"
28 |     open-pull-requests-limit: 2
29 |     groups:
30 |       all-actions:
31 |         applies-to: version-updates
32 |         patterns: [ "*" ]
33 |   - package-ecosystem: "docker"
34 |     directory: "/"
35 |     schedule:
36 |       interval: "weekly"
37 |       day: "sunday"
38 |       time: "02:00"
39 |     open-pull-requests-limit: 2
40 |     groups:
41 |       all-docker:
42 |         applies-to: version-updates
43 |         patterns: [ "*" ]


--------------------------------------------------------------------------------
/.github/workflows/release.yml:
--------------------------------------------------------------------------------
 1 | name: Publish to PyPI
 2 | 
 3 | on:
 4 |   release:
 5 |     types: [created]
 6 |   workflow_dispatch: {}
 7 | 
 8 | jobs:
 9 |   publish:
10 |     runs-on: ubuntu-latest
11 |     permissions:
12 |       id-token: write
13 |     steps:
14 |       - name: Checkout
15 |         uses: actions/checkout@v4
16 |       - name: Setup Python
17 |         uses: actions/setup-python@v5
18 |       - name: Install poetry
19 |         run: pip install poetry
20 |       - name: Install Package
21 |         run: poetry install
22 |       - name: Test Package
23 |         run: cp .env.example .env && poetry run pytest
24 |       - name: Build Package Distributions
25 |         run: poetry build
26 |       - name: Publish Package Distributions to PyPI
27 |         uses: pypa/gh-action-pypi-publish@release/v1


--------------------------------------------------------------------------------
/.github/workflows/test.yml:
--------------------------------------------------------------------------------
 1 | name: Test
 2 | 
 3 | on:
 4 |   push:
 5 |     branches:
 6 |       - master
 7 |   pull_request:
 8 |     branches:
 9 |       - master
10 |   workflow_dispatch: {}
11 | 
12 | jobs:
13 |   test:
14 |     strategy:
15 |       fail-fast: false
16 |       matrix:
17 |         python-version: ["3.10", "3.13"]
18 |     runs-on: ubuntu-latest
19 |     steps:
20 |       - name: Checkout
21 |         uses: actions/checkout@v4
22 |       - name: Setup Python ${{ matrix.python-version }}
23 |         uses: actions/setup-python@v5
24 |         with:
25 |           python-version: ${{ matrix.python-version }}
26 |       - name: Install poetry
27 |         run: pip install poetry
28 |       - name: Install Package
29 |         run: poetry install
30 |       - name: Test Package
31 |         run: cp .env.example .env && poetry run pytest


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
  1 | # Byte-compiled / optimized / DLL files
  2 | __pycache__/
  3 | *.py[cod]
  4 | *$py.class
  5 | 
  6 | # C extensions
  7 | *.so
  8 | 
  9 | # Distribution / packaging
 10 | .Python
 11 | build/
 12 | develop-eggs/
 13 | dist/
 14 | downloads/
 15 | eggs/
 16 | .eggs/
 17 | lib/
 18 | lib64/
 19 | parts/
 20 | sdist/
 21 | var/
 22 | wheels/
 23 | pip-wheel-metadata/
 24 | share/python-wheels/
 25 | *.egg-info/
 26 | .installed.cfg
 27 | *.egg
 28 | MANIFEST
 29 | *.DS_Store
 30 | .vscode
 31 | .idea
 32 | 
 33 | # Static files
 34 | polaris/collectstatic/*
 35 | !polaris/collectstatic/__init__.py
 36 | server/collectstatic/*
 37 | !server/collectstatic/__init__.py
 38 | 
 39 | # Database
 40 | data/db.sqlite3
 41 | 
 42 | # PyInstaller
 43 | #  Usually these files are written by a python script from a template
 44 | #  before PyInstaller builds the exe, so as to inject date/other infos into it.
 45 | *.manifest
 46 | *.spec
 47 | 
 48 | # Installer logs
 49 | pip-log.txt
 50 | pip-delete-this-directory.txt
 51 | 
 52 | # Unit test / coverage reports
 53 | htmlcov/
 54 | .tox/
 55 | .nox/
 56 | .coverage
 57 | .coverage.*
 58 | .cache
 59 | nosetests.xml
 60 | coverage.xml
 61 | *.cover
 62 | .hypothesis/
 63 | .pytest_cache/
 64 | 
 65 | # Translations
 66 | *.pot
 67 | 
 68 | # Django stuff:
 69 | *.log
 70 | local_settings.py
 71 | db.sqlite3-journal
 72 | 
 73 | # Flask stuff:
 74 | instance/
 75 | .webassets-cache
 76 | 
 77 | # Scrapy stuff:
 78 | .scrapy
 79 | 
 80 | # Sphinx documentation
 81 | docs/_build/
 82 | 
 83 | # PyBuilder
 84 | target/
 85 | 
 86 | # Jupyter Notebook
 87 | .ipynb_checkpoints
 88 | 
 89 | # IPython
 90 | profile_default/
 91 | ipython_config.py
 92 | 
 93 | # pyenv
 94 | .python-version
 95 | 
 96 | # pipenv
 97 | #   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
 98 | #   However, in case of collaboration, if having platform-specific dependencies or dependencies
 99 | #   having no cross-platform support, pipenv may install dependencies that don't work, or not
100 | #   install all needed dependencies.
101 | #Pipfile.lock
102 | 
103 | # SageMath parsed files
104 | *.sage.py
105 | 
106 | # Environments
107 | .env
108 | .venv
109 | env/
110 | venv/
111 | ENV/
112 | env.bak/
113 | venv.bak/
114 | 
115 | # Spyder project settings
116 | .spyderproject
117 | .spyproject
118 | 
119 | # Rope project settings
120 | .ropeproject
121 | 
122 | # mkdocs documentation
123 | /site
124 | 
125 | # mypy
126 | .mypy_cache/
127 | .dmypy.json
128 | dmypy.json
129 | 
130 | # Pyre type checker
131 | .pyre/
132 | 


--------------------------------------------------------------------------------
/Dockerfile:
--------------------------------------------------------------------------------
 1 | FROM python:3.7-slim
 2 | 
 3 | ENV PYTHONDONTWRITEBYTECODE 1
 4 | ENV PYTHONUNBUFFERED 1
 5 | ENV POETRY_CACHE_DIR /usr/local/.cache/pypoetry
 6 | 
 7 | RUN apt-get update && apt-get install -y \
 8 |     build-essential \
 9 |     libssl-dev \
10 |     libffi-dev \
11 |     python3-dev \
12 |     cargo \
13 |     postgresql \
14 |     postgresql-client \
15 |     gettext
16 | 
17 | WORKDIR /code
18 | COPY . .
19 | 
20 | RUN pip install poetry &&  \
21 |     poetry install --no-dev -E dev-server && \
22 |     ENV_PATH=/code/.env.example \
23 |     poetry run python manage.py collectstatic --no-input --ignore='*.scss'
24 | 
25 | CMD poetry run python manage.py runserver --nostatic 0.0.0.0:8000


--------------------------------------------------------------------------------
/Makefile:
--------------------------------------------------------------------------------
 1 | # Check if we need to prepend docker commands with sudo
 2 | SUDO := $(shell docker version >/dev/null 2>&1 || echo "sudo")
 3 | 
 4 | # If LABEL is not provided set default value
 5 | LABEL ?= $(shell git rev-parse --short HEAD)$(and $(shell git status -s),-dirty-$(shell id -u -n))
 6 | # If TAG is not provided set default value
 7 | TAG ?= stellar/testanchor:$(LABEL)
 8 | # https://github.com/opencontainers/image-spec/blob/master/annotations.md
 9 | BUILD_DATE := $(shell date -u +%FT%TZ)
10 | 
11 | docker-build:
12 | 	$(SUDO) docker build --pull --label org.opencontainers.image.created="$(BUILD_DATE)" -t $(TAG) .
13 | 
14 | docker-push:
15 | 	$(SUDO) docker push $(TAG)


--------------------------------------------------------------------------------
/README.rst:
--------------------------------------------------------------------------------
 1 | ==============
 2 | Django Polaris
 3 | ==============
 4 | 
 5 | .. image:: https://img.shields.io/github/actions/workflow/status/stellar/django-polaris/test.yml?branch=master
 6 |     :alt: GitHub Workflow Status
 7 |     :target: https://github.com/stellar/django-polaris/actions
 8 | 
 9 | .. image:: https://codecov.io/gh/stellar/django-polaris/branch/master/graph/badge.svg?token=3DaW3jM6Q8
10 |     :alt: Code Coverage
11 |     :target: https://codecov.io/gh/stellar/django-polaris
12 | 
13 | .. image:: https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue?style=shield
14 |     :alt: Python - Version
15 |     :target: https://pypi.python.org/pypi/django-polaris
16 | 
17 | .. image:: https://img.shields.io/badge/django-%3E=4.2-blue?style=shield
18 |     :alt: Django - Version
19 |     :target: https://pypi.python.org/pypi/django-polaris
20 | 
21 | .. _`email list`: https://groups.google.com/g/stellar-polaris
22 | .. _Stellar Development Foundation: https://www.stellar.org/
23 | .. _github: https://github.com/stellar/django-polaris
24 | .. _django app: https://docs.djangoproject.com/en/3.0/intro/reusable-apps/
25 | .. _`demo wallet`: http://demo-wallet.stellar.org
26 | .. _`reference server`: https://testanchor.stellar.org/.well-known/stellar.toml
27 | .. _`documentation`: https://django-polaris.readthedocs.io/
28 | 
29 | Polaris is an extendable `django app`_ for Stellar Ecosystem Proposal (SEP) implementations maintained by the `Stellar Development Foundation`_ (SDF). Using Polaris, you can run a web server supporting any combination of SEP-1, 6, 10, 12, 24, 31, & 38.
30 | 
31 | See the complete `documentation`_ for information on how to get started with Polaris. The SDF also runs a `reference server`_ using Polaris that can be tested using our `demo wallet`_.
32 | 
33 | For important updates on Polaris's development and releases, please join the `email list`_.
34 | 


--------------------------------------------------------------------------------
/data/.gitignore:
--------------------------------------------------------------------------------
1 | # Ignore everything in this directory
2 | *
3 | # Except this file
4 | !.gitignore


--------------------------------------------------------------------------------
/docker-compose.yml:
--------------------------------------------------------------------------------
 1 | services:
 2 |   db:
 3 |     build: .
 4 |     volumes:
 5 |       - .:/code
 6 |     command: poetry run python manage.py migrate
 7 |   server:
 8 |     container_name: server
 9 |     build: .
10 |     volumes:
11 |       - .:/code
12 |     ports:
13 |       - "8000:8000"
14 |     command: poetry run watchmedo auto-restart --recursive --pattern="*.py;*.env;*.html" --directory="." -- python manage.py runserver -- --nostatic 0.0.0.0:8000
15 |     depends_on:
16 |       db:
17 |         condition: service_completed_successfully
18 |   watch_transactions:
19 |     container_name: watch_transactions
20 |     network_mode: host
21 |     build: .
22 |     volumes:
23 |       - .:/code
24 |     depends_on:
25 |       db:
26 |         condition: service_completed_successfully
27 |     command: poetry run watchmedo auto-restart --recursive --pattern="*.py;*.env" --directory="." -- python manage.py watch_transactions
28 |   process_pending_deposits:
29 |     container_name: process_pending_deposits
30 |     network_mode: host
31 |     build: .
32 |     volumes:
33 |       - .:/code
34 |     depends_on:
35 |       db:
36 |         condition: service_completed_successfully
37 |     command: poetry run watchmedo auto-restart --recursive --pattern="*.py;*.env" --directory="." -- python manage.py process_pending_deposits
38 |   poll_outgoing_transactions:
39 |     container_name: poll_outgoing_transactions
40 |     network_mode: host
41 |     build: .
42 |     volumes:
43 |       - .:/code
44 |     depends_on:
45 |       db:
46 |         condition: service_completed_successfully
47 |     command: poetry run watchmedo auto-restart --recursive --pattern="*.py;*.env" --directory="." -- python manage.py poll_outgoing_transactions -- --loop
48 |   execute_outgoing_transactions:
49 |     container_name: execute_outgoing_transactions
50 |     network_mode: host
51 |     build: .
52 |     volumes:
53 |       - .:/code
54 |     depends_on:
55 |       db:
56 |         condition: service_completed_successfully
57 |     command: poetry run watchmedo auto-restart --recursive --pattern="*.py;*.env" --directory="." -- python manage.py execute_outgoing_transactions -- --loop
58 | 


--------------------------------------------------------------------------------
/docs/Makefile:
--------------------------------------------------------------------------------
 1 | # Minimal makefile for Sphinx documentation
 2 | #
 3 | 
 4 | # You can set these variables from the command line.
 5 | SPHINXOPTS    =
 6 | SPHINXBUILD   = sphinx-build
 7 | SOURCEDIR     = .
 8 | BUILDDIR      = build
 9 | 
10 | # Put it first so that "make" without argument is like "make help".
11 | help:
12 | 	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
13 | 
14 | .PHONY: help Makefile
15 | 
16 | # Catch-all target: route all unknown targets to Sphinx using the new
17 | # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
18 | %: Makefile
19 | 	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)


--------------------------------------------------------------------------------
/docs/custody.rst:
--------------------------------------------------------------------------------
 1 | =========================
 2 | Using a Custodial Service
 3 | =========================
 4 | 
 5 | .. _`django-polaris-circle`: https://github.com/stellar/django-polaris-circle
 6 | .. _`django-polaris-bitgo`: https://github.com/CheesecakeLabs/django-polaris-bitgo
 7 | 
 8 | Polaris defaults to a self-custody approach, meaning it assumes the business has access to the secret keys of their distribution accounts on Stellar.
 9 | 
10 | However, businesses may want to use a third-party service for custodying their on-chain assets. Polaris supports this use case through its generic :class:`~polaris.integrations.CustodyIntegration` class. Implementations of this standardized interface can connect to various custodial solutions, allowing Polaris to leverage the service's functionality.
11 | 
12 | The only implementation that is built into Polaris is the default :class:`~polaris.integrations.SelfCustodyIntegration`. As other implementations are developed, they may be added to Polaris or available as another resuable Django app.
13 | 
14 | Below is a list of in-progress or third party implementations. Because this list can only be updated on each Polaris release, it may not be exhaustive.
15 | 
16 | * `django-polaris-circle`_: a WIP impelementation for the Circle API
17 | * `django-polaris-bitgo`_: an implementation for the BitGo API
18 | 
19 | Contributions to new or existing implementations are welcome!
20 | 


--------------------------------------------------------------------------------
/docs/deployment/process_pending_deposits_flow.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/docs/deployment/process_pending_deposits_flow.png


--------------------------------------------------------------------------------
/docs/deployment/process_pending_deposits_submission_flow.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/docs/deployment/process_pending_deposits_submission_flow.png


--------------------------------------------------------------------------------
/docs/index.rst:
--------------------------------------------------------------------------------
 1 | ==============
 2 | Django Polaris
 3 | ==============
 4 | 
 5 | .. image:: https://img.shields.io/github/actions/workflow/status/stellar/django-polaris/test.yml?branch=master
 6 |     :alt: GitHub Workflow Status
 7 |     :target: https://github.com/stellar/django-polaris/actions
 8 | 
 9 | .. image:: https://codecov.io/gh/stellar/django-polaris/branch/master/graph/badge.svg?token=3DaW3jM6Q8
10 |     :alt: Code Coverage
11 |     :target: https://codecov.io/gh/stellar/django-polaris
12 | 
13 | .. image:: https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue?style=shield
14 |     :alt: Python - Version
15 |     :target: https://pypi.python.org/pypi/django-polaris
16 | 
17 | .. image:: https://img.shields.io/badge/django-%3E=4.2-blue?style=shield
18 |     :alt: Django - Version
19 |     :target: https://pypi.python.org/pypi/django-polaris
20 | 
21 | .. _`email list`: https://groups.google.com/g/stellar-polaris
22 | .. _Stellar Development Foundation: https://www.stellar.org/
23 | .. _github: https://github.com/stellar/django-polaris
24 | .. _django app: https://docs.djangoproject.com/en/5.1/intro/reusable-apps/
25 | .. _`demo wallet`: http://demo-wallet.stellar.org
26 | 
27 | Polaris is an extendable `django app`_ for Stellar Ecosystem Proposal (SEP) implementations
28 | maintained by the `Stellar Development Foundation`_ (SDF). Using Polaris, you can run a web
29 | server supporting any combination of SEP-1, 6, 10, 12, 24, 31, & 38.
30 | 
31 | While Polaris implements the majority of the functionality described in each SEP, there are
32 | pieces of functionality that can only be implemented by the developer using Polaris.
33 | For example, only an anchor can implement the integration with their partner bank.
34 | 
35 | This is why each SEP implemented by Polaris comes with a programmable interface for developers
36 | to inject their own business logic.
37 | 
38 | Polaris is completely open source and available on github_. The SDF also runs a reference
39 | server using Polaris that can be tested using our `demo wallet`_.
40 | 
41 | For important updates on Polaris's development and releases please join the `email list`_.
42 | 
43 | User Guide
44 | ==========
45 | 
46 | .. toctree::
47 |     :maxdepth: 3
48 | 
49 |     installation
50 |     sep-1
51 |     sep-10
52 |     sep-24
53 |     rails
54 |     sep-6
55 |     sep-12
56 |     sep-31
57 |     sep-38
58 |     custody
59 | 
60 | API Reference
61 | =============
62 | 
63 | .. toctree::
64 |     :maxdepth: 3
65 | 
66 |     api
67 | 
68 | Glossary
69 | ========
70 | 
71 | .. toctree::
72 |     :maxdepth: 3
73 | 
74 |     glossary
75 | 
76 | :ref:`genindex`
77 | 


--------------------------------------------------------------------------------
/docs/installation.rst:
--------------------------------------------------------------------------------
  1 | ============
  2 | Installation
  3 | ============
  4 | 
  5 | Create a Django Project
  6 | =======================
  7 | 
  8 | First you need to install the django and polaris python packages.
  9 | 
 10 | .. code-block:: shell
 11 | 
 12 |     pip install django django-polaris
 13 | 
 14 | Then you can create a project template using the following command.
 15 | 
 16 | .. code-block:: shell
 17 | 
 18 |     django-admin startproject anchor
 19 | 
 20 | You should have a project that looks like this:
 21 | 
 22 | .. code-block:: text
 23 | 
 24 |     anchor/
 25 |         manage.py
 26 |         anchor/
 27 |             __init__.py
 28 |             settings.py
 29 |             urls.py
 30 |             wsgi.py
 31 | 
 32 | Configure Settings
 33 | ==================
 34 | 
 35 | .. _corsheaders signal: https://github.com/adamchainz/django-cors-headers#signals
 36 | .. _corsheaders documentation: https://github.com/adamchainz/django-cors-headers
 37 | 
 38 | Add the following to ``INSTALLED_APPS`` in settings.py.
 39 | 
 40 | .. code-block:: python
 41 | 
 42 |     INSTALLED_APPS = [
 43 |         ...,
 44 |         "corsheaders",
 45 |         "rest_framework",
 46 |         "anchor",
 47 |         "polaris"
 48 |     ]
 49 | 
 50 | Add ``CorsMiddleware`` to your ``settings.MIDDLEWARE``. It should be listed above
 51 | other middleware that can return responses such as ``CommonMiddleware``.
 52 | 
 53 | .. code-block:: python
 54 | 
 55 |     MIDDLEWARE = [
 56 |         ...,
 57 |         'corsheaders.middleware.CorsMiddleware',
 58 |         ...
 59 |     ]
 60 | 
 61 | Polaris will accept requests from all origins to its endpoints. It does this
 62 | by adding `corsheaders signal`_ that checks the request URI. However this
 63 | does not change the CORS policy for any other endpoint on the server. You can change
 64 | this functionality using the settings listed in the `corsheaders documentation`_.
 65 | 
 66 | Set Environment Variables
 67 | =========================
 68 | 
 69 | Polaris has many different environment varibles that can be used to customize your service's configuration and behavior. A comprehensive list can be found in the :doc:`glossary`, but we'll only define whats required for now.
 70 | 
 71 | Create a ``.env`` file in the upper ``anchor/`` directory.
 72 | 
 73 | .. code-block:: shell
 74 | 
 75 |     touch anchor/.env
 76 | 
 77 | Enter the following variables.
 78 | 
 79 | .. code-block:: shell
 80 | 
 81 |     ACTIVE_SEPS=
 82 |     HOST_URL=http://localhost:8000
 83 |     LOCAL_MODE=1
 84 | 
 85 | Add Polaris Endpoints
 86 | =====================
 87 | 
 88 | Add Polaris' endpoints in ``urls.py``
 89 | ::
 90 | 
 91 |     import polaris.urls
 92 |     from django.urls import path, include
 93 | 
 94 |     urlpatterns = [
 95 |         ...,
 96 |         path("", include(polaris.urls)),
 97 |     ]
 98 | 
 99 | Configure the Database
100 | ======================
101 | 
102 | .. _Fernet symmetric encryption: https://cryptography.io/en/latest/fernet/
103 | .. _`supported by Django`: https://docs.djangoproject.com/en/5.1/ref/databases/
104 | .. _`SQLite3`: https://www.sqlite.org/index.html
105 | 
106 | Polaris works with all databases `supported by Django`_. Django's template code uses `SQLite3`_ by default, but you can install your database driver of choice and update the ``DATABASES`` setting appropriately if you'd like.
107 | 
108 | Once configured, run migrations to create these tables in your database.
109 | 
110 | .. code-block:: shell
111 | 
112 |     python manage.py migrate
113 | 
114 | You should see Django successfully apply each migration file. If an ``ImproperlyConfigured`` exception is raised, ensure all of the previous steps were performed correctly.
115 | 
116 | Run the Web Server
117 | ==================
118 | 
119 | We can now run the Django development web server.
120 | 
121 | .. code-block:: shell
122 | 
123 |     python anchor/manage.py runserver
124 | 
125 | If you navigate to http://localhost:8000 you should see Django's default home page for development.
126 | 
127 | Next, we'll begin creating our anchor by publishing a Stellar TOML file.
128 | 


--------------------------------------------------------------------------------
/docs/sep-10.rst:
--------------------------------------------------------------------------------
 1 | ======================
 2 | Require Authentication
 3 | ======================
 4 | 
 5 | .. _`SEP-10 Stellar Web Authentication`: https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0010.md
 6 | 
 7 | As defined by the `SEP-10 Stellar Web Authentication`_ specification,
 8 | 
 9 | .. epigraph::
10 | 
11 |     `This SEP defines the standard way for clients such as wallets or exchanges to create authenticated web sessions on behalf of a user who holds a Stellar account. A wallet may want to authenticate with any web service which requires a Stellar account ownership verification, for example, to upload KYC information to an anchor in an authenticated way as described in SEP-12.`
12 | 
13 | Most Polaris endpoints require a SEP-10 authentication token, refered to as the JWT, and Polaris includes an easily enabled implemenation of SEP-10 that clients can use to obtain these tokens.
14 | 
15 | It is also possile to host a SEP-10 server independent of your Polaris deployment as long as the secret used to generate the signature of each token matches the value assigned to Polaris' :term:`SERVER_JWT_KEY` environment variable. In this case, the following steps can be skipped.
16 | 
17 | Configure Settings
18 | ==================
19 | 
20 | Add SEP-10 to :term:`ACTIVE_SEPS`, and add the :term:`SIGNING_SEED` and :term:`SERVER_JWT_KEY` environment variables.
21 | 
22 | .. code-block:: shell
23 | 
24 |     ACTIVE_SEPS=sep-1,sep-10
25 |     HOST_URL=http://localhost:8000
26 |     LOCAL_MODE=1
27 |     ENABLE_SEP_0023=1
28 |     SIGNING_SEED=S...
29 |     SERVER_JWT_KEY=...
30 | 
31 | ``SIGNING_SEED`` is used to sign challenge transactions requested by client applications, and ``SERVER_JWT_KEY`` is used to verify that the authenticatoin token payload has not been tampered with.
32 | 
33 | Update the TOML File
34 | ====================
35 | 
36 | If you provided a static SEP-1 file for Polaris to use, make sure you add the ``WEB_AUTH_ENDPOINT`` attribute so clients can find your authentication service.
37 | 
38 | Confirm the API is Live
39 | =======================
40 | 
41 | Run the web server.
42 | 
43 | .. code-block::
44 | 
45 |     python anchor/manage.py runserver
46 | 
47 | You should see the ``WEB_AUTH_ENDPOINT`` URL at http://localhost:8000/.well-known/stellar.toml, and making a GET request to it should return a error responses complaining about a missing `account` parameter.
48 | 
49 | Adding Client Attribution
50 | =========================
51 | 
52 | Optionally, you can configure your authentication service to deny requests from clients that do not offer to cryptographically verify their identity. :term:`SEP10_CLIENT_ATTRIBUTION_REQUIRED` and related environment variables allow you to define an allow or denylist of domains that can authenticate with your service.
53 | 
54 | By default, Polaris does not require clients to perform this verification, but it will allow clients to do so voluntarily. In these cases, Polaris will assign the ``client_domain`` property of the :class:`polaris.sep10.token.SEP10Token` object passed to the request with the verified domain.
55 | 
56 | Issuing Tokens for Other Domains
57 | ================================
58 | 
59 | SEP-10 servers can issue authentication tokens for multiple services, including services hosted on different domains. To enable this, add the domains you would like Polaris to issue authenticaton tokens for to the :term:`SEP10_HOME_DOMAINS` environment variable.


--------------------------------------------------------------------------------
/manage.py:
--------------------------------------------------------------------------------
 1 | #!/usr/bin/env python
 2 | """Django's command-line utility for administrative tasks."""
 3 | import os
 4 | import sys
 5 | 
 6 | 
 7 | def main():
 8 |     """Main function for executing arguments."""
 9 |     os.environ.setdefault("DJANGO_SETTINGS_MODULE", "settings")
10 |     try:
11 |         from django.core.management import execute_from_command_line
12 |     except ImportError as exc:
13 |         raise ImportError(
14 |             "Couldn't import Django. Are you sure it's installed and "
15 |             "available on your PYTHONPATH environment variable? Did you "
16 |             "forget to activate a virtual environment?"
17 |         ) from exc
18 |     execute_from_command_line(sys.argv)
19 | 
20 | 
21 | if __name__ == "__main__":
22 |     main()
23 | 


--------------------------------------------------------------------------------
/polaris/__init__.py:
--------------------------------------------------------------------------------
1 | __version__ = "2.6.0"
2 | 


--------------------------------------------------------------------------------
/polaris/admin.py:
--------------------------------------------------------------------------------
 1 | from django.contrib import admin
 2 | 
 3 | from polaris.models import (
 4 |     Transaction,
 5 |     Asset,
 6 |     Quote,
 7 |     OffChainAsset,
 8 |     DeliveryMethod,
 9 |     ExchangePair,
10 | )
11 | 
12 | 
13 | class TransactionAdmin(admin.ModelAdmin):
14 |     """
15 |     This defines the admin view of a Transaction.
16 |     """
17 | 
18 |     list_display = "id", "asset_name", "kind", "status", "started_at"
19 | 
20 | 
21 | class AssetAdmin(admin.ModelAdmin):
22 |     """
23 |     This defines the admin view of an Asset.
24 |     """
25 | 
26 |     list_display = "code", "issuer", "deposit_enabled", "withdrawal_enabled"
27 | 
28 |     def get_fields(self, request, obj=None):
29 |         fields = super().get_fields(request, obj)
30 |         if not (
31 |             request.user.is_superuser
32 |             or request.user.user_permissions.filter(name="Can edit asset").exists()
33 |         ):
34 |             fields.remove("distribution_seed")
35 |         return fields
36 | 
37 | 
38 | admin.site.register(Transaction, TransactionAdmin)
39 | admin.site.register(Asset, AssetAdmin)
40 | admin.site.register(DeliveryMethod)
41 | admin.site.register(Quote)
42 | admin.site.register(OffChainAsset)
43 | admin.site.register(ExchangePair)
44 | 


--------------------------------------------------------------------------------
/polaris/apps.py:
--------------------------------------------------------------------------------
 1 | import os
 2 | from django.apps import AppConfig
 3 | from django.core.exceptions import ImproperlyConfigured
 4 | 
 5 | 
 6 | class PolarisConfig(AppConfig):
 7 |     name = "polaris"
 8 |     verbose_name = "Django Polaris"
 9 |     default_auto_field = "django.db.models.AutoField"
10 | 
11 |     def ready(self):
12 |         """
13 |         Initialize the app
14 |         """
15 |         from decimal import setcontext, DefaultContext
16 |         from polaris import settings  # loads internal settings
17 |         from polaris import cors  # loads CORS signals
18 |         from polaris.sep24.utils import check_sep24_config
19 | 
20 |         # Set in-memory precision to match database-level precision
21 |         # https://adamj.eu/tech/2020/03/23/setting-pythons-decimal-context-for-all-threads/#in-django
22 |         DefaultContext.prec = 30
23 |         setcontext(DefaultContext)
24 | 
25 |         self.check_middleware()
26 |         self.check_protocol()
27 |         if "sep-24" in settings.ACTIVE_SEPS:
28 |             check_sep24_config()
29 | 
30 |     @staticmethod
31 |     def check_middleware():
32 |         from django.conf import settings as django_settings
33 | 
34 |         cors_middleware_path = "corsheaders.middleware.CorsMiddleware"
35 |         if cors_middleware_path not in django_settings.MIDDLEWARE:
36 |             raise ImproperlyConfigured(
37 |                 f"{cors_middleware_path} is not installed in settings.MIDDLEWARE"
38 |             )
39 | 
40 |     @staticmethod
41 |     def check_protocol():
42 |         from polaris import settings
43 |         from polaris.utils import getLogger
44 |         from django.conf import settings as django_settings
45 | 
46 |         logger = getLogger(__name__)
47 |         if getattr(django_settings, "SECURE_PROXY_SSL_HEADER"):
48 |             logger.debug(
49 |                 "SECURE_PROXY_SSL_HEADER should only be set if Polaris is "
50 |                 "running behind an HTTPS reverse proxy."
51 |             )
52 |         elif not (
53 |             settings.LOCAL_MODE or getattr(django_settings, "SECURE_SSL_REDIRECT")
54 |         ):
55 |             logger.debug(
56 |                 "SECURE_SSL_REDIRECT is required to redirect HTTP traffic to HTTPS"
57 |             )
58 | 


--------------------------------------------------------------------------------
/polaris/collectstatic/__init__.py:
--------------------------------------------------------------------------------
1 | # Placeholder for git tracking
2 | 


--------------------------------------------------------------------------------
/polaris/cors.py:
--------------------------------------------------------------------------------
 1 | from corsheaders.signals import check_request_enabled
 2 | 
 3 | 
 4 | def cors_allow_origins_for_polaris_requests(sender, request, **_kwargs):
 5 |     return (
 6 |         request.path.startswith("/sep24")
 7 |         or request.path.startswith("/sep6")
 8 |         or request.path.startswith("/sep31")
 9 |         or request.path.startswith("/sep38")
10 |         or request.path.startswith("/.well-known")
11 |         or request.path.startswith("/auth")
12 |         or request.path.startswith("/kyc")
13 |     )
14 | 
15 | 
16 | check_request_enabled.connect(cors_allow_origins_for_polaris_requests)
17 | 


--------------------------------------------------------------------------------
/polaris/exceptions.py:
--------------------------------------------------------------------------------
 1 | class TransactionSubmissionError(Exception):
 2 |     pass
 3 | 
 4 | 
 5 | class TransactionSubmissionPending(TransactionSubmissionError):
 6 |     pass
 7 | 
 8 | 
 9 | class TransactionSubmissionBlocked(TransactionSubmissionError):
10 |     pass
11 | 
12 | 
13 | class TransactionSubmissionFailed(TransactionSubmissionError):
14 |     pass
15 | 


--------------------------------------------------------------------------------
/polaris/integrations/fees.py:
--------------------------------------------------------------------------------
 1 | from typing import Dict, List, Optional
 2 | from decimal import Decimal
 3 | 
 4 | from rest_framework.request import Request
 5 | 
 6 | from polaris import settings
 7 | from polaris.models import Asset
 8 | 
 9 | 
10 | def calculate_fee(
11 |     fee_params: Dict, *_args: List, request: Optional[Request] = None, **_kwargs: Dict
12 | ) -> Decimal:
13 |     """
14 |     .. _`/fee`: https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0024.md#fee
15 | 
16 |     Calculate the fee to be charged for the transaction described by `fee_params`.
17 | 
18 |     Note that this endpoint only supports calculating fees expressed in units of a
19 |     Stellar asset. If fees cannot be calculated using the `fee_params` passed,
20 |     raise a ``ValueError`` for Polaris to return a 400 Bad Request to the client.
21 | 
22 |     Replace this function with another by passing it to ``register_integrations()``
23 |     as described in :ref:`api:Register Integrations`
24 |     if the fees charged for transactions is not calculated using the asset's
25 |     ``fee_fixed`` and ``fee_percent`` attributes.
26 | 
27 |     If replaced, `/info` responses will no longer contain the ``fee_fixed`` and
28 |     ``fee_percent`` attributes per-asset. This is because Polaris can no longer
29 |     assume fees are determined using those attributes alone.
30 | 
31 |     `fee_params` will always contain the following key-value pairs:
32 | 
33 |     - `amount`: ``Decimal``
34 |     - `asset_code`: ``str``
35 |     - `operation`: ``str``
36 |     - `type`: ``str``
37 | 
38 |     Each of these key-value pairs correspond to the associated parameter for the
39 |     `/fee`_ endpoint. The Decimal returned will be used as the `fee` value in the
40 |     response.
41 |     """
42 |     amount = fee_params["amount"]
43 |     asset = Asset.objects.filter(code=fee_params["asset_code"]).first()
44 |     if fee_params["operation"] == settings.OPERATION_WITHDRAWAL:
45 |         fee_percent = asset.withdrawal_fee_percent
46 |         fee_fixed = asset.withdrawal_fee_fixed
47 |     elif fee_params["operation"] == settings.OPERATION_DEPOSIT:
48 |         fee_percent = asset.deposit_fee_percent
49 |         fee_fixed = asset.deposit_fee_fixed
50 |     elif fee_params["operation"] == settings.OPERATION_SEND:
51 |         fee_percent = asset.send_fee_percent
52 |         fee_fixed = asset.send_fee_fixed
53 |     else:
54 |         raise ValueError(f"unexpected operation: {fee_params['operation']}")
55 | 
56 |     if fee_fixed is None and fee_percent is None:
57 |         return Decimal(0)
58 | 
59 |     if fee_fixed is None:
60 |         fee_fixed = Decimal(0)
61 |     elif fee_percent is None:
62 |         fee_percent = Decimal(0)
63 | 
64 |     return round(
65 |         fee_fixed + (fee_percent / Decimal("100") * Decimal(amount)),
66 |         asset.significant_decimals,
67 |     )
68 | 
69 | 
70 | registered_fee_func = calculate_fee
71 | 


--------------------------------------------------------------------------------
/polaris/integrations/info.py:
--------------------------------------------------------------------------------
 1 | from typing import Dict, Optional, List
 2 | 
 3 | from rest_framework.request import Request
 4 | 
 5 | from polaris.models import Asset
 6 | 
 7 | 
 8 | def default_info_func(
 9 |     request: Request,
10 |     asset: Asset,
11 |     lang: Optional[str],
12 |     exchange: bool,
13 |     *args: List,
14 |     **kwargs: Dict
15 | ) -> Dict:
16 |     """
17 |     .. _/info response: https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0006.md#response-2
18 | 
19 |     Replace this function with another by passing it to ``register_integrations()``
20 |     as described in :ref:`api:Register Integrations`.
21 | 
22 |     Return a dictionary containing the `fields` and `types` key-value pairs
23 |     described in the SEP-6 /info response for the asset passed. Raise a
24 |     ``ValueError()`` if `lang` is not supported. For example,
25 |     ::
26 | 
27 |         if asset.code == "USD":
28 |             return {
29 |                 "fields": {
30 |                     "email_address" : {
31 |                         "description": "your email address for transaction status updates",
32 |                         "optional": True
33 |                     },
34 |                     "amount" : {
35 |                         "description": "amount in USD that you plan to deposit"
36 |                     },
37 |                     "type" : {
38 |                         "description": "type of deposit to make",
39 |                         "choices": ["SEPA", "SWIFT", "cash"]
40 |                     }
41 |                 },
42 |                 "types": {
43 |                     "bank_account": {
44 |                         "fields": {
45 |                             "dest": {"description": "your bank account number" },
46 |                             "dest_extra": { "description": "your routing number" },
47 |                             "bank_branch": { "description": "address of your bank branch" },
48 |                             "phone_number": { "description": "your phone number in case there's an issue" }
49 |                         }
50 |                     },
51 |                     "cash": {
52 |                         "fields": {
53 |                             "dest": {
54 |                                 "description": "your email address. Your cashout PIN will be sent here.",
55 |                                 "optional": True
56 |                             }
57 |                         }
58 |                     }
59 |                 }
60 |             }
61 | 
62 |     :param request: a ``rest_framework.request.Request`` object
63 |     :param asset: ``Asset`` object for which to return the `fields` and `types`
64 |         key-value pairs
65 |     :param lang: the language code the client requested for the `description`
66 |         values in the response
67 |     :param exchange: whether or not the info returned will be used for a
68 |         `deposit-exchange` or `withdraw-exchange` response object. Only
69 |         relevant if SEP-38 is enabled.
70 |     """
71 |     raise NotImplementedError()
72 | 
73 | 
74 | registered_info_func = default_info_func
75 | 


--------------------------------------------------------------------------------
/polaris/integrations/toml.py:
--------------------------------------------------------------------------------
 1 | from typing import List, Dict
 2 | 
 3 | from rest_framework.request import Request
 4 | 
 5 | from polaris.models import Asset
 6 | 
 7 | 
 8 | def get_stellar_toml(request: Request, *args: List, **kwargs: Dict):
 9 |     """
10 |     .. _SEP-1: https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0001.md
11 |     .. _`Account Info`: https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0001.md#account-information
12 | 
13 |     Replace this function with another by passing it to ``register_integrations()``.
14 | 
15 |     The dictionary returned will be merged with Polaris' default attributes and serialized
16 |     using the ``toml.dumps()`` function. The output will be rendered in the HTTP response.
17 | 
18 |     The base attributes provided by Polaris are:
19 | 
20 |     - `ACCOUNTS`
21 |     - `VERSION`
22 |     - `SIGNING_KEY`
23 |     - `NETWORK_PASSPHRASE`
24 |     - `WEB_AUTH_ENDPOINT`
25 |     - `TRANSFER_SERVER`
26 |     - `TRANSFER_SERVER_0024`
27 |     - `KYC_SERVER`
28 |     - `DIRECT_PAYMENT_SERVER`
29 |     - `QUOTE_SERVER`
30 | 
31 |     The contents of the dictionary returned will overwrite the default matching key values.
32 | 
33 |     :return: a dictionary of SEP-1_ attributes
34 |     """
35 |     return {
36 |         "CURRENCIES": [
37 |             {"code": asset.code, "issuer": asset.issuer}
38 |             for asset in Asset.objects.all()
39 |         ]
40 |     }
41 | 
42 | 
43 | registered_toml_func = get_stellar_toml
44 | 


--------------------------------------------------------------------------------
/polaris/locale/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/locale/__init__.py


--------------------------------------------------------------------------------
/polaris/locale/id/LC_MESSAGES/django.mo:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/locale/id/LC_MESSAGES/django.mo


--------------------------------------------------------------------------------
/polaris/locale/pt/LC_MESSAGES/django.mo:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/locale/pt/LC_MESSAGES/django.mo


--------------------------------------------------------------------------------
/polaris/locale/utils.py:
--------------------------------------------------------------------------------
 1 | from django.utils import translation
 2 | from django.utils.translation import get_supported_language_variant
 3 | 
 4 | 
 5 | def validate_or_use_default_language(lang: str) -> str:
 6 |     if not lang:
 7 |         return "en"
 8 |     try:
 9 |         get_supported_language_variant(lang)
10 |     except LookupError:
11 |         return "en"
12 |     return lang
13 | 
14 | 
15 | def activate_lang_for_request(lang: str):
16 |     translation.activate(lang)
17 | 


--------------------------------------------------------------------------------
/polaris/management/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/management/__init__.py


--------------------------------------------------------------------------------
/polaris/management/commands/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/management/commands/__init__.py


--------------------------------------------------------------------------------
/polaris/middleware.py:
--------------------------------------------------------------------------------
 1 | import pytz
 2 | from django.utils import timezone
 3 | 
 4 | 
 5 | class TimezoneMiddleware:
 6 |     """
 7 |     .. _timezones: https://docs.djangoproject.com/en/3.2/topics/i18n/timezones/
 8 | 
 9 |     Adapted from the Django documentation on timezones_. It checks for a
10 |     ``"timezone"`` key stored in the request session and uses it when rendering
11 |     content returned in the response.
12 | 
13 |     Polaris includes a ``timezone.js`` script that detects the users' UTC offset
14 |     and sends it to the server, which stores a timezone with that offset in the
15 |     user's session. This script is automatically loaded if using a template that
16 |     inherits from ``base.html``.
17 | 
18 |     However, there is a limitation with this approach. For users's without exising
19 |     sessions, which are identified using a browser cookie, Polaris cannot detect the
20 |     user's timezone prior to rendering the first page of content. This means that
21 |     dates and times shown to on the first page to a new user will be in the default
22 |     timezone specified in your project's settings.
23 | 
24 |     That is why Django's documentation recommends that you simply ask the user what
25 |     timezone they would like to use instead of attempting to detect it automatically.
26 |     If this approach is taken, simply save the specified timezone in the user's session
27 |     under the ``"timezone"`` key after adding this middleware.
28 |     """
29 | 
30 |     def __init__(self, get_response):
31 |         self.get_response = get_response
32 | 
33 |     def __call__(self, request):
34 |         tzname = request.session.get("timezone")
35 |         if tzname:
36 |             timezone.activate(pytz.timezone(tzname))
37 |         else:
38 |             timezone.deactivate()
39 |         return self.get_response(request)
40 | 


--------------------------------------------------------------------------------
/polaris/migrations/0002_auto_20200921_2135.py:
--------------------------------------------------------------------------------
 1 | # Generated by Django 2.2.16 on 2020-09-21 21:35
 2 | 
 3 | from django.db import migrations, models
 4 | import polaris.models
 5 | 
 6 | 
 7 | class Migration(migrations.Migration):
 8 |     dependencies = [
 9 |         ("polaris", "0001_initial"),
10 |     ]
11 | 
12 |     operations = [
13 |         migrations.AddField(
14 |             model_name="transaction",
15 |             name="envelope_xdr",
16 |             field=models.TextField(
17 |                 null=True, validators=[polaris.models.deserialize], blank=True
18 |             ),
19 |         ),
20 |         migrations.AddField(
21 |             model_name="transaction",
22 |             name="pending_signatures",
23 |             field=models.BooleanField(default=False),
24 |         ),
25 |         migrations.AddField(
26 |             model_name="transaction",
27 |             name="channel_seed",
28 |             field=models.TextField(null=True, blank=True),
29 |         ),
30 |         migrations.AddField(
31 |             model_name="asset",
32 |             name="distribution_account_signers",
33 |             field=models.TextField(null=True, blank=True),
34 |         ),
35 |         migrations.AddField(
36 |             model_name="asset",
37 |             name="distribution_account_thresholds",
38 |             field=models.TextField(null=True, blank=True),
39 |         ),
40 |         migrations.AddField(
41 |             model_name="asset",
42 |             name="distribution_account_master_signer",
43 |             field=models.TextField(null=True, blank=True),
44 |         ),
45 |     ]
46 | 


--------------------------------------------------------------------------------
/polaris/migrations/0003_auto_20201009_1300.py:
--------------------------------------------------------------------------------
 1 | from django.db import migrations, models
 2 | import polaris.models
 3 | 
 4 | 
 5 | class Migration(migrations.Migration):
 6 |     dependencies = [
 7 |         ("polaris", "0002_auto_20200921_2135"),
 8 |     ]
 9 | 
10 |     operations = [
11 |         migrations.RemoveField(
12 |             model_name="asset", name="distribution_account_master_signer"
13 |         ),
14 |         migrations.RemoveField(model_name="asset", name="distribution_account_signers"),
15 |         migrations.RemoveField(
16 |             model_name="asset", name="distribution_account_thresholds"
17 |         ),
18 |     ]
19 | 


--------------------------------------------------------------------------------
/polaris/migrations/0004_auto_20201120_1541.py:
--------------------------------------------------------------------------------
 1 | # Generated by Django 2.2.16 on 2020-11-20 15:41
 2 | 
 3 | from django.db import migrations, models
 4 | 
 5 | 
 6 | class Migration(migrations.Migration):
 7 |     dependencies = [
 8 |         ("polaris", "0003_auto_20201009_1300"),
 9 |     ]
10 | 
11 |     operations = [
12 |         migrations.AddField(
13 |             model_name="transaction",
14 |             name="claimable_balance_id",
15 |             field=models.TextField(blank=True, null=True),
16 |         ),
17 |         migrations.AddField(
18 |             model_name="transaction",
19 |             name="claimable_balance_supported",
20 |             field=models.BooleanField(default=False),
21 |         ),
22 |     ]
23 | 


--------------------------------------------------------------------------------
/polaris/migrations/0005_auto_20210226_0053.py:
--------------------------------------------------------------------------------
 1 | # Generated by Django 2.2.18 on 2021-02-26 00:53
 2 | 
 3 | from django.db import migrations
 4 | import polaris.models
 5 | 
 6 | 
 7 | def encrypt_channel_seeds(apps, _):
 8 |     Transaction = apps.get_model("polaris", "Transaction")
 9 |     channel_seed_txs = Transaction.objects.filter(channel_seed__isnull=False).all()
10 |     for tx in channel_seed_txs:
11 |         tx.channel_seed = polaris.models.EncryptedTextField.encrypt(tx.channel_seed)
12 |         tx.save()
13 | 
14 | 
15 | def decrypt_channel_seeds(apps, _):
16 |     Transaction = apps.get_model("polaris", "Transaction")
17 |     channel_seed_txs = Transaction.objects.filter(channel_seed__isnull=False).all()
18 |     for tx in channel_seed_txs:
19 |         tx.channel_seed = polaris.models.EncryptedTextField.decrypt(tx.channel_seed)
20 |         tx.save()
21 | 
22 | 
23 | class Migration(migrations.Migration):
24 |     dependencies = [
25 |         ("polaris", "0004_auto_20201120_1541"),
26 |     ]
27 | 
28 |     operations = [
29 |         migrations.RunPython(encrypt_channel_seeds, decrypt_channel_seeds),
30 |         migrations.AlterField(
31 |             model_name="transaction",
32 |             name="channel_seed",
33 |             field=polaris.models.EncryptedTextField(blank=True, null=True),
34 |         ),
35 |     ]
36 | 


--------------------------------------------------------------------------------
/polaris/migrations/0006_transaction_more_info_url.py:
--------------------------------------------------------------------------------
 1 | # Generated by Django 2.2.18 on 2021-02-26 23:53
 2 | 
 3 | from django.db import migrations, models
 4 | from django.db.models.functions import Concat
 5 | from polaris import settings
 6 | from polaris.shared.endpoints import SEP6_MORE_INFO_PATH
 7 | from polaris.sep24.urls import SEP24_MORE_INFO_PATH
 8 | 
 9 | 
10 | def populate_more_info_urls(apps, _):
11 |     Transaction = apps.get_model("polaris", "Transaction")
12 |     if "sep-24" in settings.ACTIVE_SEPS:
13 |         Transaction.objects.filter(protocol="sep24").update(
14 |             more_info_url=Concat(
15 |                 models.Value(f"{settings.HOST_URL}{SEP24_MORE_INFO_PATH}?id="),
16 |                 models.F("id"),
17 |                 output_field=models.TextField(null=True, blank=True),
18 |             ),
19 |         )
20 |     if "sep-6" in settings.ACTIVE_SEPS:
21 |         Transaction.objects.filter(protocol="sep6").update(
22 |             more_info_url=Concat(
23 |                 models.Value(f"{settings.HOST_URL}{SEP6_MORE_INFO_PATH}?id="),
24 |                 models.F("id"),
25 |                 output_field=models.TextField(null=True, blank=True),
26 |             ),
27 |         )
28 | 
29 | 
30 | def noop(*_):
31 |     # the DB column can be dropped without any reversal logic
32 |     pass
33 | 
34 | 
35 | class Migration(migrations.Migration):
36 |     dependencies = [
37 |         ("polaris", "0005_auto_20210226_0053"),
38 |     ]
39 | 
40 |     operations = [
41 |         migrations.AddField(
42 |             model_name="transaction",
43 |             name="more_info_url",
44 |             field=models.TextField(blank=True, null=True),
45 |         ),
46 |         migrations.RunPython(populate_more_info_urls, noop),
47 |     ]
48 | 


--------------------------------------------------------------------------------
/polaris/migrations/0007_transaction_on_change_callback.py:
--------------------------------------------------------------------------------
 1 | # Generated by Django 2.2.18 on 2021-03-01 18:28
 2 | 
 3 | from django.db import migrations, models
 4 | 
 5 | 
 6 | class Migration(migrations.Migration):
 7 |     dependencies = [
 8 |         ("polaris", "0006_transaction_more_info_url"),
 9 |     ]
10 | 
11 |     operations = [
12 |         migrations.AddField(
13 |             model_name="transaction",
14 |             name="on_change_callback",
15 |             field=models.TextField(blank=True, null=True),
16 |         ),
17 |     ]
18 | 


--------------------------------------------------------------------------------
/polaris/migrations/0008_transaction_pending_execution_attempt.py:
--------------------------------------------------------------------------------
 1 | # Generated by Django 2.2.19 on 2021-03-17 23:38
 2 | 
 3 | from django.db import migrations, models
 4 | 
 5 | 
 6 | class Migration(migrations.Migration):
 7 |     dependencies = [
 8 |         ("polaris", "0007_transaction_on_change_callback"),
 9 |     ]
10 | 
11 |     operations = [
12 |         migrations.AddField(
13 |             model_name="transaction",
14 |             name="pending_execution_attempt",
15 |             field=models.BooleanField(default=False),
16 |         ),
17 |     ]
18 | 


--------------------------------------------------------------------------------
/polaris/migrations/0009_transaction_client_domain.py:
--------------------------------------------------------------------------------
 1 | # Generated by Django 2.2.18 on 2021-02-05 01:58
 2 | 
 3 | from django.db import migrations, models
 4 | 
 5 | 
 6 | class Migration(migrations.Migration):
 7 |     dependencies = [
 8 |         ("polaris", "0008_transaction_pending_execution_attempt"),
 9 |     ]
10 | 
11 |     operations = [
12 |         migrations.AddField(
13 |             model_name="transaction",
14 |             name="client_domain",
15 |             field=models.TextField(blank=True, null=True),
16 |         ),
17 |     ]
18 | 


--------------------------------------------------------------------------------
/polaris/migrations/0010_auto_20210809_1605.py:
--------------------------------------------------------------------------------
 1 | # Generated by Django 2.2.24 on 2021-08-09 16:05
 2 | 
 3 | from django.db import migrations, models
 4 | import polaris.models
 5 | 
 6 | 
 7 | class Migration(migrations.Migration):
 8 |     dependencies = [
 9 |         ("polaris", "0009_transaction_client_domain"),
10 |     ]
11 | 
12 |     operations = [
13 |         migrations.AlterField(
14 |             model_name="asset",
15 |             name="distribution_seed",
16 |             field=polaris.models.EncryptedTextField(blank=True, null=True),
17 |         ),
18 |         migrations.AlterField(
19 |             model_name="transaction",
20 |             name="completed_at",
21 |             field=models.DateTimeField(blank=True, null=True),
22 |         ),
23 |         migrations.AlterField(
24 |             model_name="transaction",
25 |             name="paging_token",
26 |             field=models.TextField(blank=True, null=True),
27 |         ),
28 |         migrations.AlterField(
29 |             model_name="transaction",
30 |             name="protocol",
31 |             field=models.CharField(
32 |                 blank=True,
33 |                 choices=[("sep6", "sep6"), ("sep24", "sep24"), ("sep31", "sep31")],
34 |                 max_length=5,
35 |                 null=True,
36 |             ),
37 |         ),
38 |     ]
39 | 


--------------------------------------------------------------------------------
/polaris/migrations/0011_transaction_amount_expected.py:
--------------------------------------------------------------------------------
 1 | # Generated by Django 2.2.24 on 2021-08-17 20:37
 2 | 
 3 | from django.db import migrations, models
 4 | 
 5 | 
 6 | def match_amount_in(apps, _schema_editor):
 7 |     Transaction = apps.get_model("polaris", "Transaction")
 8 |     Transaction.objects.update(amount_expected=models.F("amount_in"))
 9 | 
10 | 
11 | def nop(*_):
12 |     pass
13 | 
14 | 
15 | class Migration(migrations.Migration):
16 |     dependencies = [
17 |         ("polaris", "0010_auto_20210809_1605"),
18 |     ]
19 | 
20 |     operations = [
21 |         migrations.AddField(
22 |             model_name="transaction",
23 |             name="amount_expected",
24 |             field=models.DecimalField(
25 |                 blank=True, decimal_places=7, max_digits=30, null=True
26 |             ),
27 |         ),
28 |         migrations.RunPython(match_amount_in, nop),
29 |     ]
30 | 


--------------------------------------------------------------------------------
/polaris/migrations/0012_auto_20210918_2053.py:
--------------------------------------------------------------------------------
 1 | # Generated by Django 3.2.7 on 2021-09-18 20:53
 2 | 
 3 | from django.db import migrations, models
 4 | 
 5 | 
 6 | class Migration(migrations.Migration):
 7 |     dependencies = [
 8 |         ("polaris", "0011_transaction_amount_expected"),
 9 |     ]
10 | 
11 |     operations = [
12 |         migrations.AddField(
13 |             model_name="transaction",
14 |             name="account_memo",
15 |             field=models.PositiveIntegerField(blank=True, null=True),
16 |         ),
17 |         migrations.AddField(
18 |             model_name="transaction",
19 |             name="muxed_account",
20 |             field=models.TextField(blank=True, null=True),
21 |         ),
22 |     ]
23 | 


--------------------------------------------------------------------------------
/polaris/migrations/0014_auto_20220211_0624.py:
--------------------------------------------------------------------------------
 1 | # Generated by Django 3.2.9 on 2022-02-11 06:24
 2 | 
 3 | from django.db import migrations, models
 4 | import polaris.models
 5 | 
 6 | 
 7 | class Migration(migrations.Migration):
 8 |     dependencies = [
 9 |         ("polaris", "0013_auto_20211011_1956"),
10 |     ]
11 | 
12 |     operations = [
13 |         migrations.CreateModel(
14 |             name="PolarisHeartbeat",
15 |             fields=[
16 |                 (
17 |                     "id",
18 |                     models.AutoField(
19 |                         auto_created=True,
20 |                         primary_key=True,
21 |                         serialize=False,
22 |                         verbose_name="ID",
23 |                     ),
24 |                 ),
25 |                 ("key", models.CharField(max_length=80, unique=True)),
26 |                 ("last_heartbeat", models.DateTimeField(blank=True, null=True)),
27 |             ],
28 |         ),
29 |         migrations.AddField(
30 |             model_name="transaction",
31 |             name="queue",
32 |             field=models.TextField(blank=True, null=True),
33 |         ),
34 |         migrations.AddField(
35 |             model_name="transaction",
36 |             name="queued_at",
37 |             field=models.DateTimeField(blank=True, null=True),
38 |         ),
39 |         migrations.AddField(
40 |             model_name="transaction",
41 |             name="submission_status",
42 |             field=models.CharField(
43 |                 choices=[
44 |                     ("not_ready", "not_ready"),
45 |                     ("ready", "ready"),
46 |                     ("processing", "processing"),
47 |                     ("pending", "pending"),
48 |                     ("pending_funding", "pending_funding"),
49 |                     ("pending_trust", "pending_trust"),
50 |                     ("blocked", "blocked"),
51 |                     ("unblocked", "unblocked"),
52 |                     ("completed", "completed"),
53 |                     ("failed", "failed"),
54 |                 ],
55 |                 default="not_ready",
56 |                 max_length=31,
57 |             ),
58 |         ),
59 |     ]
60 | 


--------------------------------------------------------------------------------
/polaris/migrations/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/migrations/__init__.py


--------------------------------------------------------------------------------
/polaris/sep1/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/sep1/__init__.py


--------------------------------------------------------------------------------
/polaris/sep1/urls.py:
--------------------------------------------------------------------------------
1 | """This module defines the URL patterns for the `/.well-known/stellar.toml` endpoint."""
2 | from django.urls import re_path
3 | 
4 | from polaris.sep1.views import generate_toml
5 | 
6 | urlpatterns = [re_path(r"^stellar.toml/?$", generate_toml)]
7 | 


--------------------------------------------------------------------------------
/polaris/sep1/views.py:
--------------------------------------------------------------------------------
 1 | """
 2 | This module implements the logic for the `/.well-known` endpoint.
 3 | In particular, this generates the `.toml` file for the anchor server.
 4 | 
 5 | The importance of the Stellar TOML file is explained in SEP-0001:
 6 | https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0001.md
 7 | """
 8 | 
 9 | import os
10 | 
11 | import toml
12 | from django.contrib.staticfiles import finders
13 | from django.utils.encoding import smart_str
14 | from rest_framework.request import Request
15 | from rest_framework.response import Response
16 | from rest_framework.renderers import BaseRenderer
17 | from rest_framework.decorators import api_view, renderer_classes
18 | 
19 | from polaris import settings
20 | from polaris.utils import getLogger
21 | from polaris.integrations import (
22 |     registered_toml_func,
23 |     get_stellar_toml,
24 |     registered_custody_integration as rci,
25 | )
26 | from polaris.models import Asset
27 | 
28 | 
29 | logger = getLogger(__name__)
30 | 
31 | 
32 | class PolarisPlainTextRenderer(BaseRenderer):
33 |     """
34 |     .. _documentation: https://www.django-rest-framework.org/api-guide/renderers/#custom-renderers
35 | 
36 |     Source copied from django-rest-framework's documentation_
37 |     """
38 | 
39 |     media_type = "text/plain"
40 |     format = "txt"
41 | 
42 |     def render(self, data, media_type=None, renderer_context=None):
43 |         return smart_str(data, encoding=self.charset)
44 | 
45 | 
46 | @api_view(["GET"])
47 | @renderer_classes([PolarisPlainTextRenderer])
48 | def generate_toml(request: Request) -> Response:
49 |     """Generate a TOML-formatted string"""
50 |     if registered_toml_func is get_stellar_toml:
51 |         # integration function is not used, check to see if a static file is defined
52 |         static_toml = None
53 |         if settings.LOCAL_MODE:
54 |             static_toml = finders.find("polaris/local-stellar.toml")
55 |         if not static_toml:
56 |             static_toml = finders.find("polaris/stellar.toml")
57 |         if static_toml:
58 |             with open(static_toml) as f:
59 |                 return Response(f.read(), content_type="text/plain")
60 | 
61 |     # The anchor uses the registered TOML function, replaced or not
62 |     toml_dict = {
63 |         "NETWORK_PASSPHRASE": settings.STELLAR_NETWORK_PASSPHRASE,
64 |     }
65 |     distribution_accounts = []
66 |     for asset in Asset.objects.all():
67 |         try:
68 |             distribution_accounts.append(rci.get_distribution_account(asset))
69 |         except NotImplementedError:
70 |             break
71 |     if distribution_accounts:
72 |         toml_dict["ACCOUNTS"] = distribution_accounts
73 |     if "sep-24" in settings.ACTIVE_SEPS:
74 |         toml_dict["TRANSFER_SERVER"] = os.path.join(settings.HOST_URL, "sep24")
75 |         toml_dict["TRANSFER_SERVER_SEP0024"] = toml_dict["TRANSFER_SERVER"]
76 |     if "sep-6" in settings.ACTIVE_SEPS:
77 |         toml_dict["TRANSFER_SERVER"] = os.path.join(settings.HOST_URL, "sep6")
78 |     if "sep-10" in settings.ACTIVE_SEPS:
79 |         toml_dict["WEB_AUTH_ENDPOINT"] = os.path.join(settings.HOST_URL, "auth")
80 |         toml_dict["SIGNING_KEY"] = settings.SIGNING_KEY
81 |     if "sep-12" in settings.ACTIVE_SEPS:
82 |         toml_dict["KYC_SERVER"] = os.path.join(settings.HOST_URL, "kyc")
83 |     if "sep-31" in settings.ACTIVE_SEPS:
84 |         toml_dict["DIRECT_PAYMENT_SERVER"] = os.path.join(settings.HOST_URL, "sep31")
85 |     if "sep-38" in settings.ACTIVE_SEPS:
86 |         toml_dict["ANCHOR_QUOTE_SERVER"] = os.path.join(settings.HOST_URL, "sep38")
87 | 
88 |     toml_dict.update(registered_toml_func(request))
89 |     content = toml.dumps(toml_dict)
90 | 
91 |     return Response(content, content_type="text/plain")
92 | 


--------------------------------------------------------------------------------
/polaris/sep10/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/sep10/__init__.py


--------------------------------------------------------------------------------
/polaris/sep10/urls.py:
--------------------------------------------------------------------------------
1 | """This module defines the URL patterns for the `/auth` endpoint."""
2 | from django.urls import path
3 | from polaris.sep10.views import SEP10Auth
4 | 
5 | urlpatterns = [path("", SEP10Auth.as_view())]
6 | 


--------------------------------------------------------------------------------
/polaris/sep10/utils.py:
--------------------------------------------------------------------------------
 1 | from rest_framework import status
 2 | from rest_framework.request import Request
 3 | from rest_framework.response import Response
 4 | 
 5 | from polaris.sep10.token import SEP10Token
 6 | from polaris.utils import render_error_response
 7 | 
 8 | 
 9 | def check_auth(request, func, *args, **kwargs):
10 |     """
11 |     Check SEP 10 authentication in a request.
12 |     Else call the original view function.
13 |     """
14 |     try:
15 |         token = validate_jwt_request(request)
16 |     except (ValueError, TypeError) as e:
17 |         if "sep6/" in request.path:
18 |             return Response({"type": "authentication_required"}, status=403)
19 |         else:
20 |             return render_error_response(str(e), status_code=status.HTTP_403_FORBIDDEN)
21 |     return func(token, request, *args, **kwargs)
22 | 
23 | 
24 | def validate_sep10_token():
25 |     """Decorator to validate the SEP 10 token in a request."""
26 | 
27 |     def decorator(view):
28 |         def wrapper(request, *args, **kwargs):
29 |             return check_auth(request, view, *args, **kwargs)
30 | 
31 |         return wrapper
32 | 
33 |     return decorator
34 | 
35 | 
36 | def validate_jwt_request(request: Request) -> SEP10Token:
37 |     """
38 |     Validate the JSON web token in a request and return the source account address
39 | 
40 |     :raises ValueError: invalid JWT
41 |     """
42 |     # While the SEP 24 spec calls the authorization header "Authorization", django middleware
43 |     # renames this as "HTTP_AUTHORIZATION". We check this header for the JWT.
44 |     jwt_header = request.headers.get("Authorization")
45 |     if not jwt_header:
46 |         raise ValueError("JWT must be passed as 'Authorization' header")
47 |     bad_format_error = ValueError(
48 |         "'Authorization' header must be formatted as 'Bearer <token>'"
49 |     )
50 |     if "Bearer" not in jwt_header:
51 |         raise bad_format_error
52 |     try:
53 |         encoded_jwt = jwt_header.split(" ")[1]
54 |     except IndexError:
55 |         raise bad_format_error
56 |     if not encoded_jwt:
57 |         raise bad_format_error
58 | 
59 |     try:
60 |         return SEP10Token(encoded_jwt)
61 |     except ValueError as e:
62 |         raise ValueError(f"SEP-10 token error: {str(e)}")
63 | 


--------------------------------------------------------------------------------
/polaris/sep12/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/sep12/__init__.py


--------------------------------------------------------------------------------
/polaris/sep12/urls.py:
--------------------------------------------------------------------------------
 1 | from django.urls import re_path
 2 | from polaris.sep12 import customer
 3 | 
 4 | urlpatterns = [
 5 |     re_path(r"^customer/callback/?$", customer.callback),
 6 |     re_path(r"^customer/verification/?$", customer.put_verification),
 7 |     re_path(r"^customer/(?P<account>[^/]+)/?$", customer.delete),
 8 |     re_path(r"^customer/?$", customer.CustomerAPIView.as_view()),
 9 | ]
10 | 


--------------------------------------------------------------------------------
/polaris/sep24/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/sep24/__init__.py


--------------------------------------------------------------------------------
/polaris/sep24/fee.py:
--------------------------------------------------------------------------------
 1 | """This module defines the `/fee` view."""
 2 | 
 3 | from rest_framework.decorators import api_view, renderer_classes
 4 | from rest_framework.response import Response
 5 | from rest_framework.renderers import JSONRenderer
 6 | from rest_framework.request import Request
 7 | 
 8 | from polaris.shared import endpoints
 9 | 
10 | 
11 | @api_view(["GET"])
12 | @renderer_classes([JSONRenderer])
13 | def fee(request: Request) -> Response:
14 |     """
15 |     SEP-24 and SEP-6 /fee endpoints are identical
16 |     """
17 |     return endpoints.fee(request)
18 | 


--------------------------------------------------------------------------------
/polaris/sep24/info.py:
--------------------------------------------------------------------------------
 1 | """This module defines the logic for the `/info` endpoint."""
 2 | from typing import Dict
 3 | 
 4 | from rest_framework.decorators import api_view, renderer_classes
 5 | from rest_framework.response import Response
 6 | from rest_framework.renderers import JSONRenderer, BrowsableAPIRenderer
 7 | 
 8 | from polaris.locale.utils import (
 9 |     activate_lang_for_request,
10 |     validate_or_use_default_language,
11 | )
12 | from polaris.models import Asset
13 | from polaris.integrations import (
14 |     registered_custody_integration as rci,
15 | )
16 | 
17 | 
18 | def _get_asset_info(asset: Asset, op_type: str) -> Dict:
19 |     if not getattr(asset, f"{op_type}_enabled"):
20 |         return {"enabled": False}
21 | 
22 |     asset_info = {"enabled": True}
23 |     min_amount_attr = f"{op_type}_min_amount"
24 |     max_amount_attr = f"{op_type}_max_amount"
25 |     min_amount = getattr(asset, min_amount_attr)
26 |     max_amount = getattr(asset, max_amount_attr)
27 |     if min_amount > getattr(Asset, "_meta").get_field(min_amount_attr).default:
28 |         asset_info["min_amount"] = min_amount
29 |     if max_amount < getattr(Asset, "_meta").get_field(max_amount_attr).default:
30 |         asset_info["max_amount"] = max_amount
31 |     if getattr(asset, f"{op_type}_fee_fixed") is not None:
32 |         asset_info["fee_fixed"] = getattr(asset, f"{op_type}_fee_fixed")
33 |     if getattr(asset, f"{op_type}_fee_percent") is not None:
34 |         asset_info["fee_percent"] = getattr(asset, f"{op_type}_fee_percent")
35 | 
36 |     return asset_info
37 | 
38 | 
39 | @api_view()
40 | @renderer_classes([JSONRenderer, BrowsableAPIRenderer])
41 | def info(request):
42 |     """
43 |     Definition of the /info endpoint, in accordance with SEP-0024.
44 |     See: https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0024.md#info
45 |     """
46 |     activate_lang_for_request(validate_or_use_default_language(request.GET.get("lang")))
47 |     info_data = {
48 |         "deposit": {},
49 |         "withdraw": {},
50 |         "fee": {"enabled": True},
51 |         "features": {
52 |             "account_creation": rci.account_creation_supported,
53 |             "claimable_balances": rci.claimable_balances_supported,
54 |         },
55 |     }
56 | 
57 |     for asset in Asset.objects.filter(sep24_enabled=True):
58 |         info_data["deposit"][asset.code] = _get_asset_info(asset, "deposit")
59 |         info_data["withdraw"][asset.code] = _get_asset_info(asset, "withdrawal")
60 | 
61 |     return Response(info_data)
62 | 


--------------------------------------------------------------------------------
/polaris/sep24/transaction.py:
--------------------------------------------------------------------------------
 1 | from rest_framework.decorators import api_view, renderer_classes
 2 | from rest_framework.response import Response
 3 | from rest_framework.request import Request
 4 | from rest_framework.renderers import (
 5 |     TemplateHTMLRenderer,
 6 |     JSONRenderer,
 7 |     BrowsableAPIRenderer,
 8 | )
 9 | 
10 | from django.views.decorators.clickjacking import xframe_options_exempt
11 | 
12 | from polaris.shared import endpoints
13 | from polaris.sep10.utils import validate_sep10_token
14 | from polaris.sep10.token import SEP10Token
15 | 
16 | 
17 | @xframe_options_exempt
18 | @api_view(["GET"])
19 | @renderer_classes([TemplateHTMLRenderer])
20 | def more_info(request: Request) -> Response:
21 |     """
22 |     Popup to display more information about a specific transaction.
23 |     See table: https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0024.md#4-customer-information-status
24 |     """
25 |     return endpoints.more_info(request)
26 | 
27 | 
28 | @api_view(["GET"])
29 | @renderer_classes([JSONRenderer, BrowsableAPIRenderer])
30 | @validate_sep10_token()
31 | def transactions(
32 |     token: SEP10Token,
33 |     request: Request,
34 | ) -> Response:
35 |     """
36 |     Definition of the /transactions endpoint, in accordance with SEP-0024.
37 |     See: https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0024.md#transaction-history
38 |     """
39 |     return endpoints.transactions_request(request, token)
40 | 
41 | 
42 | @api_view(["GET"])
43 | @renderer_classes([JSONRenderer, BrowsableAPIRenderer])
44 | @validate_sep10_token()
45 | def transaction(
46 |     token: SEP10Token,
47 |     request: Request,
48 | ) -> Response:
49 |     """
50 |     Definition of the /transaction endpoint, in accordance with SEP-0024.
51 |     See: https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0024.md#single-historical-transaction
52 |     """
53 |     return endpoints.transaction_request(request, token)
54 | 


--------------------------------------------------------------------------------
/polaris/sep24/tzinfo.py:
--------------------------------------------------------------------------------
 1 | import pytz
 2 | from datetime import datetime, timedelta, timezone
 3 | 
 4 | from rest_framework.decorators import api_view, parser_classes, renderer_classes
 5 | from rest_framework.parsers import JSONParser
 6 | from rest_framework.renderers import JSONRenderer
 7 | from rest_framework.request import Request
 8 | from rest_framework.response import Response
 9 | from django.contrib.sessions.backends.db import SessionStore
10 | 
11 | from polaris.utils import render_error_response, getLogger
12 | 
13 | 
14 | logger = getLogger(__name__)
15 | 
16 | 
17 | @api_view(["POST"])
18 | @parser_classes([JSONParser])
19 | @renderer_classes([JSONRenderer])
20 | def post_tzinfo(request: Request) -> Response:
21 |     if not (
22 |         request.data.get("sessionId") and request.data.get("sessionOffset") is not None
23 |     ):
24 |         return render_error_response("missing required parameters")
25 |     now = datetime.now(timezone.utc)
26 |     offset = timedelta(minutes=request.data["sessionOffset"])
27 |     zone = None
28 |     for tz in map(pytz.timezone, pytz.all_timezones_set):
29 |         if now.astimezone(tz).utcoffset() == offset:
30 |             zone = tz.zone
31 |             break
32 |     if not zone:
33 |         return render_error_response("no timezones matched with offset")
34 |     session = SessionStore(session_key=request.data["sessionId"])
35 |     session["timezone"] = zone
36 |     session.save()
37 |     return Response({"status": "ok", "tz": zone})
38 | 


--------------------------------------------------------------------------------
/polaris/sep24/urls.py:
--------------------------------------------------------------------------------
 1 | from django.urls import re_path
 2 | from django.views.decorators.csrf import csrf_exempt
 3 | 
 4 | from polaris.sep24.info import info
 5 | from polaris.sep24.fee import fee
 6 | from polaris.sep24.transaction import more_info, transaction, transactions
 7 | from polaris.sep24.withdraw import (
 8 |     withdraw,
 9 |     get_interactive_withdraw,
10 |     post_interactive_withdraw,
11 |     complete_interactive_withdraw,
12 | )
13 | from polaris.sep24.deposit import (
14 |     deposit,
15 |     complete_interactive_deposit,
16 |     post_interactive_deposit,
17 |     get_interactive_deposit,
18 | )
19 | from polaris.sep24.tzinfo import post_tzinfo
20 | 
21 | SEP24_MORE_INFO_PATH = "transaction/more_info"
22 | 
23 | urlpatterns = [
24 |     re_path(r"^transactions/deposit/interactive/?$", csrf_exempt(deposit)),
25 |     re_path(
26 |         r"^transactions/deposit/interactive/complete/?$",
27 |         complete_interactive_deposit,
28 |         name="complete_interactive_withdraw",
29 |     ),
30 |     re_path(
31 |         r"^transactions/deposit/webapp/submit/?$",
32 |         post_interactive_deposit,
33 |         name="post_interactive_deposit",
34 |     ),
35 |     re_path(
36 |         r"^transactions/deposit/webapp/?$",
37 |         get_interactive_deposit,
38 |         name="get_interactive_deposit",
39 |     ),
40 |     re_path(r"^transactions/withdraw/interactive/?$", csrf_exempt(withdraw)),
41 |     re_path(
42 |         r"^transactions/withdraw/interactive/complete/?$",
43 |         complete_interactive_withdraw,
44 |         name="complete_interactive_withdraw",
45 |     ),
46 |     re_path(
47 |         r"^transactions/withdraw/webapp/submit/?$",
48 |         post_interactive_withdraw,
49 |         name="post_interactive_withdraw",
50 |     ),
51 |     re_path(
52 |         r"^transactions/withdraw/webapp/?$",
53 |         get_interactive_withdraw,
54 |         name="get_interactive_withdraw",
55 |     ),
56 |     re_path(r"^transactions/webapp/tzinfo/?$", post_tzinfo, name="tzinfo"),
57 |     re_path(r"^info/?$", info),
58 |     re_path(r"^fee/?$", fee),
59 |     re_path(r"^transaction/?$", transaction),
60 |     re_path(r"^transactions/?$", transactions),
61 |     re_path(r"^" + SEP24_MORE_INFO_PATH + r"/?$", more_info, name="more_info"),
62 | ]
63 | 


--------------------------------------------------------------------------------
/polaris/sep31/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/sep31/__init__.py


--------------------------------------------------------------------------------
/polaris/sep31/serializers.py:
--------------------------------------------------------------------------------
 1 | import json
 2 | from datetime import timezone
 3 | 
 4 | from rest_framework import serializers
 5 | 
 6 | from polaris.models import Transaction
 7 | from polaris.settings import DATETIME_FORMAT
 8 | 
 9 | 
10 | class SEP31TransactionSerializer(serializers.ModelSerializer):
11 |     id = serializers.CharField()
12 |     stellar_account_id = serializers.SerializerMethodField()
13 |     stellar_memo = serializers.SerializerMethodField()
14 |     stellar_memo_type = serializers.SerializerMethodField()
15 |     required_info_message = serializers.SerializerMethodField()
16 |     required_info_updates = serializers.SerializerMethodField()
17 |     started_at = serializers.DateTimeField(
18 |         format=DATETIME_FORMAT, default_timezone=timezone.utc
19 |     )
20 |     completed_at = serializers.DateTimeField(
21 |         format=DATETIME_FORMAT, default_timezone=timezone.utc
22 |     )
23 | 
24 |     @staticmethod
25 |     def get_stellar_account_id(instance):
26 |         return instance.receiving_anchor_account
27 | 
28 |     @staticmethod
29 |     def get_stellar_memo(instance):
30 |         return instance.memo
31 | 
32 |     @staticmethod
33 |     def get_stellar_memo_type(instance):
34 |         return instance.memo_type
35 | 
36 |     @staticmethod
37 |     def get_required_info_message(instance):
38 |         return instance.required_info_message
39 | 
40 |     @staticmethod
41 |     def get_required_info_updates(instance):
42 |         if instance.required_info_updates:
43 |             return json.loads(instance.required_info_updates)
44 |         else:
45 |             return None
46 | 
47 |     def to_representation(self, instance):
48 |         data = super().to_representation(instance)
49 |         self._round_decimals(data, instance)
50 |         if instance.quote:
51 |             data["amount_in_asset"] = instance.quote.sell_asset
52 |             data["amount_out_asset"] = instance.quote.buy_asset
53 |             if instance.fee_asset:
54 |                 data["amount_fee_asset"] = instance.fee_asset
55 |         return data
56 | 
57 |     @staticmethod
58 |     def _round_decimals(data, instance):
59 |         """
60 |         Rounds each decimal field to instance.asset.significant_decimals.
61 | 
62 |         Note that this requires an additional database query for the asset.
63 |         If this serializer was initialized to serialize many instances, this
64 |         function will be called for each instance unless ``same_asset: True``
65 |         is included as a key-value pair in self.context.
66 | 
67 |         If the transactions to be serialized are for multiple assets, split
68 |         the calls to this serializer by asset.
69 |         """
70 |         asset = instance.asset
71 |         for field in ["amount_in", "amount_out", "amount_fee"]:
72 |             if getattr(instance, field) is None:
73 |                 continue
74 |             data[field] = str(
75 |                 round(getattr(instance, field), asset.significant_decimals)
76 |             )
77 | 
78 |     class Meta:
79 |         model = Transaction
80 |         fields = [
81 |             "id",
82 |             "status",
83 |             "status_eta",
84 |             "amount_in",
85 |             "amount_out",
86 |             "amount_fee",
87 |             "started_at",
88 |             "completed_at",
89 |             "stellar_transaction_id",
90 |             "external_transaction_id",
91 |             "refunded",
92 |             # fields with getter methods
93 |             "stellar_account_id",
94 |             "stellar_memo",
95 |             "stellar_memo_type",
96 |             "required_info_updates",
97 |             "required_info_message",
98 |         ]
99 | 


--------------------------------------------------------------------------------
/polaris/sep31/urls.py:
--------------------------------------------------------------------------------
 1 | from django.urls import re_path
 2 | from polaris.sep31 import info, transactions
 3 | 
 4 | urlpatterns = [
 5 |     re_path(r"^info/?$", info.info),
 6 |     re_path(
 7 |         r"^transactions/(?P<transaction_id>[^/]+)/?$",
 8 |         transactions.TransactionsAPIView.as_view(),
 9 |     ),
10 |     re_path(r"^transactions/?$", transactions.TransactionsAPIView.as_view()),
11 | ]
12 | 


--------------------------------------------------------------------------------
/polaris/sep38/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/sep38/__init__.py


--------------------------------------------------------------------------------
/polaris/sep38/info.py:
--------------------------------------------------------------------------------
 1 | from rest_framework.decorators import api_view, renderer_classes
 2 | from rest_framework.renderers import JSONRenderer
 3 | from rest_framework.request import Request
 4 | from rest_framework.response import Response
 5 | 
 6 | from polaris.sep38.serializers import OffChainAssetSerializer
 7 | from polaris.models import Asset, OffChainAsset
 8 | 
 9 | 
10 | @api_view(["GET"])
11 | @renderer_classes([JSONRenderer])
12 | def info(_: Request) -> Response:
13 |     """
14 |     Definition of the /info endpoint, in accordance with SEP-0038.
15 |     See: https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0038.md#response
16 |     """
17 |     info_data = {"assets": []}
18 |     for asset in Asset.objects.filter(sep38_enabled=True):
19 |         info_data["assets"].append({"asset": f"stellar:{asset.code}:{asset.issuer}"})
20 |     info_data["assets"].extend(
21 |         OffChainAssetSerializer(OffChainAsset.objects.all(), many=True).data
22 |     )
23 |     return Response(info_data)
24 | 


--------------------------------------------------------------------------------
/polaris/sep38/serializers.py:
--------------------------------------------------------------------------------
  1 | from datetime import timezone
  2 | 
  3 | from rest_framework import serializers
  4 | 
  5 | from polaris.models import Asset, Quote, OffChainAsset, DeliveryMethod
  6 | from polaris.settings import DATETIME_FORMAT
  7 | 
  8 | 
  9 | class QuoteSerializer(serializers.ModelSerializer):
 10 |     def __init__(self, data, *args, **kwargs):
 11 |         # cache each asset model fetched from the serializer methods
 12 |         self.sell_assets = {}
 13 |         self.buy_assets = {}
 14 |         super().__init__(data, *args, **kwargs)
 15 | 
 16 |     price = serializers.SerializerMethodField()
 17 |     sell_amount = serializers.SerializerMethodField()
 18 |     buy_amount = serializers.SerializerMethodField()
 19 |     expires_at = serializers.DateTimeField(
 20 |         format=DATETIME_FORMAT, default_timezone=timezone.utc
 21 |     )
 22 | 
 23 |     @staticmethod
 24 |     def cache_asset(asset: str, cache: dict):
 25 |         if asset not in cache:
 26 |             if asset.startswith("stellar"):
 27 |                 _, code, issuer = asset.split(":")
 28 |                 asset_obj = Asset.objects.get(code=code, issuer=issuer)
 29 |             else:
 30 |                 scheme, identifier = asset.split(":")
 31 |                 asset_obj = OffChainAsset.objects.get(
 32 |                     scheme=scheme, identifier=identifier
 33 |                 )
 34 |             cache[asset] = asset_obj
 35 | 
 36 |     def get_price(self, instance):
 37 |         self.cache_asset(instance.sell_asset, self.sell_assets)
 38 |         return str(
 39 |             round(
 40 |                 instance.price,
 41 |                 self.sell_assets[instance.sell_asset].significant_decimals,
 42 |             )
 43 |         )
 44 | 
 45 |     def get_sell_amount(self, instance):
 46 |         self.cache_asset(instance.sell_asset, self.sell_assets)
 47 |         return str(
 48 |             round(
 49 |                 instance.sell_amount,
 50 |                 self.sell_assets[instance.sell_asset].significant_decimals,
 51 |             )
 52 |         )
 53 | 
 54 |     def get_buy_amount(self, instance):
 55 |         self.cache_asset(instance.buy_asset, self.buy_assets)
 56 |         return str(
 57 |             round(
 58 |                 instance.buy_amount,
 59 |                 self.buy_assets[instance.buy_asset].significant_decimals,
 60 |             )
 61 |         )
 62 | 
 63 |     class Meta:
 64 |         model = Quote
 65 |         fields = [
 66 |             "id",
 67 |             "price",
 68 |             "expires_at",
 69 |             "sell_asset",
 70 |             "buy_asset",
 71 |             "sell_amount",
 72 |             "buy_amount",
 73 |         ]
 74 | 
 75 | 
 76 | class OffChainAssetSerializer(serializers.ModelSerializer):
 77 |     asset = serializers.SerializerMethodField()
 78 |     country_codes = serializers.SerializerMethodField()
 79 |     sell_delivery_methods = serializers.SerializerMethodField()
 80 |     buy_delivery_methods = serializers.SerializerMethodField()
 81 | 
 82 |     @staticmethod
 83 |     def get_asset(instance):
 84 |         return instance.asset_identification_format
 85 | 
 86 |     @staticmethod
 87 |     def get_country_codes(instance):
 88 |         if instance.country_codes:
 89 |             return [cc.strip() for cc in instance.country_codes.split(",")]
 90 |         else:
 91 |             return []
 92 | 
 93 |     @staticmethod
 94 |     def get_sell_delivery_methods(instance):
 95 |         return DeliveryMethodSerializer(
 96 |             instance.delivery_methods.filter(type=DeliveryMethod.TYPE.sell),
 97 |             many=True,
 98 |         ).data
 99 | 
100 |     @staticmethod
101 |     def get_buy_delivery_methods(instance):
102 |         return DeliveryMethodSerializer(
103 |             instance.delivery_methods.filter(type=DeliveryMethod.TYPE.buy),
104 |             many=True,
105 |         ).data
106 | 
107 |     class Meta:
108 |         model = OffChainAsset
109 |         fields = [
110 |             "asset",
111 |             "country_codes",
112 |             "sell_delivery_methods",
113 |             "buy_delivery_methods",
114 |         ]
115 | 
116 | 
117 | class DeliveryMethodSerializer(serializers.ModelSerializer):
118 |     class Meta:
119 |         model = DeliveryMethod
120 |         fields = ["name", "description"]
121 | 


--------------------------------------------------------------------------------
/polaris/sep38/urls.py:
--------------------------------------------------------------------------------
 1 | from django.urls import re_path
 2 | 
 3 | from polaris.sep38 import info, prices, quote
 4 | 
 5 | urlpatterns = [
 6 |     re_path(r"^info/?$", info.info),
 7 |     re_path(r"^prices/?$", prices.get_prices),
 8 |     re_path(r"^price/?$", prices.get_price),
 9 |     re_path(r"^quote/?$", quote.post_quote),
10 |     re_path(r"^quote/(?P<quote_id>[^/]+)/?$", quote.get_quote),
11 | ]
12 | 


--------------------------------------------------------------------------------
/polaris/sep6/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/sep6/__init__.py


--------------------------------------------------------------------------------
/polaris/sep6/fee.py:
--------------------------------------------------------------------------------
 1 | from rest_framework.decorators import api_view, renderer_classes
 2 | from rest_framework.response import Response
 3 | from rest_framework.renderers import JSONRenderer
 4 | from rest_framework.request import Request
 5 | 
 6 | from polaris.shared import endpoints
 7 | 
 8 | 
 9 | @api_view(["GET"])
10 | @renderer_classes([JSONRenderer])
11 | def fee(request: Request) -> Response:
12 |     """
13 |     SEP-24 and SEP-6 /fee endpoints are identical
14 |     """
15 |     return endpoints.fee(request, sep6=True)
16 | 


--------------------------------------------------------------------------------
/polaris/sep6/transaction.py:
--------------------------------------------------------------------------------
  1 | from django.utils.translation import gettext as _
  2 | from django.views.decorators.clickjacking import xframe_options_exempt
  3 | from django.core.exceptions import ValidationError, ObjectDoesNotExist
  4 | from rest_framework.decorators import api_view, renderer_classes
  5 | from rest_framework.response import Response
  6 | from rest_framework.request import Request
  7 | from rest_framework.renderers import (
  8 |     TemplateHTMLRenderer,
  9 |     JSONRenderer,
 10 |     BrowsableAPIRenderer,
 11 | )
 12 | 
 13 | from polaris.shared import endpoints
 14 | from polaris.sep10.utils import validate_sep10_token
 15 | from polaris.sep10.token import SEP10Token
 16 | from polaris.utils import (
 17 |     render_error_response,
 18 |     getLogger,
 19 |     validate_patch_request_fields,
 20 | )
 21 | from polaris.models import Transaction
 22 | from polaris.integrations import (
 23 |     registered_deposit_integration as rdi,
 24 |     registered_withdrawal_integration as rwi,
 25 | )
 26 | 
 27 | logger = getLogger(__name__)
 28 | 
 29 | 
 30 | @xframe_options_exempt
 31 | @api_view(["GET"])
 32 | @renderer_classes([TemplateHTMLRenderer])
 33 | def more_info(request: Request) -> Response:
 34 |     """
 35 |     Popup to display more information about a specific transaction.
 36 |     See table: https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0024.md#4-customer-information-status
 37 |     """
 38 |     return endpoints.more_info(request, sep6=True)
 39 | 
 40 | 
 41 | @api_view(["GET"])
 42 | @renderer_classes([JSONRenderer, BrowsableAPIRenderer])
 43 | @validate_sep10_token()
 44 | def transactions(token: SEP10Token, request: Request) -> Response:
 45 |     """
 46 |     Definition of the /transactions endpoint, in accordance with SEP-0006.
 47 |     See: https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0006.md#transaction-history
 48 |     """
 49 |     if token.account != request.GET.get("account"):
 50 |         return render_error_response(
 51 |             _("The account specified does not match authorization token"),
 52 |             status_code=403,
 53 |         )
 54 |     return endpoints.transactions_request(request, token, sep6=True)
 55 | 
 56 | 
 57 | @api_view(["GET"])
 58 | @renderer_classes([JSONRenderer, BrowsableAPIRenderer])
 59 | @validate_sep10_token()
 60 | def transaction(token: SEP10Token, request: Request) -> Response:
 61 |     """
 62 |     Definition of the /transaction endpoint, in accordance with SEP-0006.
 63 |     See: https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0006.md#single-historical-transaction
 64 |     """
 65 |     return endpoints.transaction_request(request, token, sep6=True)
 66 | 
 67 | 
 68 | @api_view(["PATCH"])
 69 | @renderer_classes([JSONRenderer, BrowsableAPIRenderer])
 70 | @validate_sep10_token()
 71 | def patch_transaction(token: SEP10Token, request: Request, transaction_id: str):
 72 |     try:
 73 |         t = Transaction.objects.get(
 74 |             id=transaction_id,
 75 |             stellar_account=token.account,
 76 |             protocol=Transaction.PROTOCOL.sep6,
 77 |         )
 78 |     except (ValidationError, ObjectDoesNotExist):
 79 |         return render_error_response(_("transaction not found"), status_code=404)
 80 |     if t.status != Transaction.STATUS.pending_transaction_info_update:
 81 |         return render_error_response(_("update not required"))
 82 |     try:
 83 |         validate_patch_request_fields(request.data, t)
 84 |     except ValueError as e:
 85 |         return render_error_response(str(e))
 86 |     except RuntimeError as e:
 87 |         logger.exception(str(e))
 88 |         return render_error_response(_("unable to process request"), status_code=500)
 89 |     integration = rdi if t.kind == Transaction.KIND.deposit else rwi
 90 |     try:
 91 |         integration.patch_transaction(
 92 |             token=token, request=request, params=request.data, transaction=t
 93 |         )
 94 |     except ValueError as e:
 95 |         return render_error_response(str(e))
 96 |     except NotImplementedError:
 97 |         return render_error_response(_("not implemented"), status_code=501)
 98 |     t.status = Transaction.STATUS.pending_anchor
 99 |     t.required_info_updates = None
100 |     t.required_info_message = None
101 |     t.save()
102 |     return Response(status=200)
103 | 


--------------------------------------------------------------------------------
/polaris/sep6/urls.py:
--------------------------------------------------------------------------------
 1 | from django.urls import re_path
 2 | 
 3 | from polaris import settings
 4 | from polaris.sep6 import info, deposit, withdraw, fee, transaction
 5 | 
 6 | urlpatterns = [
 7 |     re_path(r"^deposit/?$", deposit.deposit),
 8 |     re_path(r"^withdraw/?$", withdraw.withdraw),
 9 |     re_path(r"^info/?$", info.info),
10 |     re_path(r"^fee/?$", fee.fee),
11 |     re_path(r"^transaction/?$", transaction.transaction),
12 |     re_path(
13 |         r"^transactions/(?P<transaction_id>[^/]+)/?$", transaction.patch_transaction
14 |     ),
15 |     re_path(r"^transactions/?$", transaction.transactions),
16 | ]
17 | if settings.SEP6_USE_MORE_INFO_URL:
18 |     urlpatterns.append(
19 |         re_path(
20 |             r"^transaction/more_info/?$", transaction.more_info, name="more_info_sep6"
21 |         ),
22 |     )
23 | if "sep-38" in settings.ACTIVE_SEPS:
24 |     urlpatterns.extend(
25 |         [
26 |             re_path(r"^deposit-exchange/?$", deposit.deposit_exchange),
27 |             re_path(r"^withdraw-exchange/?$", withdraw.withdraw_exchange),
28 |         ]
29 |     )
30 | 


--------------------------------------------------------------------------------
/polaris/sep6/utils.py:
--------------------------------------------------------------------------------
 1 | from typing import Dict
 2 | 
 3 | from rest_framework.request import Request
 4 | 
 5 | from polaris.utils import getLogger
 6 | from polaris.utils import SEP_9_FIELDS
 7 | from polaris.integrations import registered_customer_integration as rci
 8 | from polaris.models import Transaction
 9 | from polaris.sep10.token import SEP10Token
10 | from polaris import settings
11 | 
12 | 
13 | logger = getLogger(__name__)
14 | 
15 | 
16 | def validate_403_response(
17 |     token: SEP10Token,
18 |     request: Request,
19 |     integration_response: Dict,
20 |     transaction: Transaction,
21 | ) -> Dict:
22 |     """
23 |     Ensures the response returned from `process_sep6_request()` matches the definitions
24 |     described in SEP-6. This function can be used for both /deposit and /withdraw
25 |     endpoints since the response schemas are identical.
26 | 
27 |     Note that this validation function is only for 403 responses. /deposit and /withdraw
28 |     have distinct 200 Success response schemas so the validation for those are done in
29 |     depost.py and withdraw.py.
30 | 
31 |     :param integration_response: the response dictionary returned from
32 |         `process_sep6_request()`
33 |     :param transaction: the transaction object that should not be saved to the DB
34 |     :return: a new dictionary containing the valid key-value pairs from
35 |         integration_response
36 |     """
37 |     if Transaction.objects.filter(id=transaction.id).exists():
38 |         logger.error(
39 |             "transaction cannot be saved when returning 403 SEP-6 deposit/withdraw response"
40 |         )
41 |         raise ValueError()
42 | 
43 |     statuses = ["pending", "denied"]
44 |     types = ["customer_info_status", "non_interactive_customer_info_needed"]
45 |     response = {"type": integration_response["type"]}
46 |     if response["type"] not in types:
47 |         logger.error("Invalid 'type' returned from process_sep6_request()")
48 |         raise ValueError()
49 | 
50 |     elif response["type"] == types[0]:
51 |         if integration_response.get("status") not in statuses:
52 |             logger.error("Invalid 'status' returned from process_sep6_request()")
53 |             raise ValueError()
54 |         response["status"] = integration_response["status"]
55 |         if settings.SEP6_USE_MORE_INFO_URL:
56 |             more_info_url = rci.more_info_url(
57 |                 token=token,
58 |                 request=request,
59 |                 account=token.muxed_account or token.account,
60 |                 memo=token.memo,
61 |             )
62 |             response["more_info_url"] = more_info_url
63 | 
64 |     else:
65 |         if "fields" not in integration_response:
66 |             logger.error(f"missing 'fields' for {types[1]}")
67 |             raise ValueError()
68 |         elif not isinstance(integration_response["fields"], list):
69 |             logger.error(f"invalid 'fields' for {types[1]}")
70 |             raise ValueError()
71 |         elif not all(f in SEP_9_FIELDS for f in integration_response["fields"]):
72 |             logger.error(f"invalid 'fields' for {types[1]}")
73 |             raise ValueError()
74 |         else:
75 |             response["fields"] = integration_response["fields"]
76 | 
77 |     return response
78 | 


--------------------------------------------------------------------------------
/polaris/shared/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/shared/__init__.py


--------------------------------------------------------------------------------
/polaris/static/polaris/base.scss:
--------------------------------------------------------------------------------
  1 | @import "reset.scss";
  2 | @import "normalize.scss";
  3 | @import "colors.scss";
  4 | @import "form-styles/forms.scss";
  5 | 
  6 | html {
  7 |   font-size: 16px;
  8 |   background-image: linear-gradient(to bottom, $gradient-start, $gradient-end);
  9 |   color: $text-color;
 10 |   -webkit-font-smoothing: antialiased;
 11 |   -moz-osx-font-smoothing: grayscale;
 12 | }
 13 | 
 14 | body {
 15 |   min-width: 15rem;
 16 |   box-sizing: border-box;
 17 |   font-family: $main-typeface;
 18 | 
 19 |   & *,
 20 |   & *:before,
 21 |   & *:after {
 22 |     box-sizing: inherit;
 23 |   }
 24 | }
 25 | 
 26 | .bottom {
 27 |   padding-bottom: 2rem;
 28 |   margin: auto;
 29 | }
 30 | 
 31 | img.logo {
 32 |   width: 150px;
 33 |   height: 100px;
 34 |   margin-bottom: 10px;
 35 |   object-fit: contain;
 36 | }
 37 | 
 38 | .main-content {
 39 |   overflow-x: hidden;
 40 | }
 41 | 
 42 | .navbar {
 43 |   padding-top: 3rem;
 44 |   padding-bottom: 1rem;
 45 |   display: flex;
 46 |   justify-content: center;
 47 |   margin: auto;
 48 | }
 49 | 
 50 | .navbar-brand {
 51 |   display: flex;
 52 |   flex-direction: column;
 53 |   align-items: center;
 54 | }
 55 | 
 56 | .section {
 57 |   padding: 1rem;
 58 |   max-width: 25rem;
 59 |   margin: auto;
 60 | }
 61 | 
 62 | .info-item--inline {
 63 |   &.info-item {
 64 |     padding: 0.5rem 0;
 65 |     display: flex;
 66 |     flex-direction: row;
 67 |     align-items: baseline;
 68 |   }
 69 |   .info-label {
 70 |     padding-right: 0.5rem;
 71 |     padding-bottom: 0;
 72 |   }
 73 |   .info-value {
 74 |     font-size: 14/16 + rem;
 75 |   }
 76 | }
 77 | 
 78 | .info-item {
 79 |   padding: 0.75rem 0;
 80 | 
 81 |   &.info-item--highlight {
 82 |     border-top: 0.0625rem solid rgba($light_-2, 0.1);
 83 |     line-height: 1.5;
 84 |     .info-label {
 85 |       color: $light_-2;
 86 |     }
 87 | 
 88 |     .info-value {
 89 |       color: $light_-2;
 90 |     }
 91 |   }
 92 | }
 93 | 
 94 | .info-label {
 95 |   text-transform: capitalize;
 96 |   color: $lightest-gray;
 97 |   font-size: 14/16 + rem;
 98 |   line-height: 1;
 99 |   padding-bottom: 0.25rem;
100 | }
101 | 
102 | .info-value {
103 |   font-size: 1rem;
104 |   color: $light_-2;
105 | }
106 | 
107 | .polaris-fee-table {
108 |   width: 100%;
109 |   border-collapse: collapse;
110 |   line-height: 2;
111 |   background-color: rgba(7, 7, 11, 0.35);
112 |   border-radius: 0.75rem;
113 | }
114 | .polaris-fee-row {
115 |   border-bottom: 1px solid white;
116 | }
117 | .polaris-fee-label {
118 |   padding-left: 1rem;
119 | }
120 | .polaris-fee-total-label {
121 |   padding-left: 1rem;
122 | }
123 | .polaris-fee-value {
124 |   text-align: right;
125 |   padding-right: 1rem;
126 | }
127 | .polaris-fee-total-value {
128 |   text-align: right;
129 |   padding-right: 1rem;
130 | }
131 | 


--------------------------------------------------------------------------------
/polaris/static/polaris/chevron-down.svg:
--------------------------------------------------------------------------------
1 | <svg xmlns="http://www.w3.org/2000/svg" width="7.73" height="6.82">
2 |   <path fill="#94A0AC" fill-rule="evenodd" d="M6.98 0c.41 0 .75.34.75.76 0 .13-.03.2-.09.35l-3.08 5.3c-.15.25-.38.37-.66.41h-.07a.87.87 0 01-.65-.4L.09 1.12C.03.96 0 .88 0 .75 0 .34.34 0 .76 0h6.22z"/>
3 | </svg>
4 | 


--------------------------------------------------------------------------------
/polaris/static/polaris/colors.scss:
--------------------------------------------------------------------------------
 1 | $white: #ffffff;
 2 | 
 3 | $dark-gray: #07070b;
 4 | $light-gray: #727b84;
 5 | $lightest-gray: #94a0ac;
 6 | 
 7 | $light_-2: #ffffff;
 8 | // $light_-1: ;
 9 | $light_0: #bdc9d4;
10 | // $light_1: ;
11 | $light_2: #94a0ac;
12 | 
13 | $alpha-light_-2: rgba($light_-2, 0.35);
14 | // $alpha-light_-1: rgba($light_-1, .35);
15 | $alpha-light_0: rgba($light_0, 0.35);
16 | // $alpha-light_1: rgba($light_1, .35);
17 | $alpha-light_2: rgba($light_2, 0.35);
18 | 
19 | $dark_-2: #94a0ac;
20 | $dark_-1: #565a75;
21 | $dark_0: #303346;
22 | $dark_1: #1a1b22;
23 | $dark_2: #07070b;
24 | 
25 | $alpha-dark_-2: rgba($dark_-2, 0.35);
26 | $alpha-dark_-1: rgba($dark_-1, 0.35);
27 | $alpha-dark_0: rgba($dark_0, 0.35);
28 | $alpha-dark_1: rgba($dark_1, 0.35);
29 | $alpha-dark_2: rgba($dark_2, 0.35);
30 | 
31 | // $success_-2: ;
32 | // $success_-1: ;
33 | $success_0: #0dbb9c;
34 | // $success_1: ;
35 | // $success_2: ;
36 | 
37 | // $primary_-2: ;
38 | // $primary_-1: ;
39 | $primary_0: #33e1ff;
40 | // $primary_1: ;
41 | // $primary_2: ;
42 | 
43 | // $danger_-2: ;
44 | // $danger_-1: ;
45 | $danger_0: #e64755;
46 | // $danger_1: ;
47 | // $danger_2: ;
48 | 


--------------------------------------------------------------------------------
/polaris/static/polaris/company-icon.svg:
--------------------------------------------------------------------------------
1 | <?xml version="1.0" encoding="UTF-8"?>
2 | <svg width="798px" height="676px" viewBox="0 0 798 676" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
3 |     <!-- Generator: Sketch 61.2 (89653) - https://sketch.com -->
4 |     <title>Lumen Large White</title>
5 |     <desc>Created with Sketch.</desc>
6 |     <g id="Lumen-Large-White" stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
7 |         <path d="M799,169.054291 L799,237.878396 L769.89186,252.684367 C747.784279,263.961198 734.61432,287.389076 736.485192,312.111075 C737.128279,320.697187 737.466746,329.384709 737.466746,338.072231 C737.425505,465.145711 666.031783,581.460903 552.66498,639.152664 C439.298177,696.844425 303.112788,686.165135 200.150787,611.509455 L200.150787,611.509455 L259.924014,581.086226 L263.308682,579.294635 C349.090795,627.331453 453.939638,626.35985 538.814502,576.741605 C623.689367,527.12336 675.872538,436.293309 675.933491,338.072231 C675.929678,325.909677 675.13827,313.760101 673.564224,301.69957 L673.564224,301.69957 L207.935522,538.662722 L111.607886,587.677925 L-1,644.975007 L-1,575.981884 L112.38636,518.279159 L167.488746,490.188377 L799,169.054291 Z M245.251958,36.8896225 C358.61932,-20.8417207 494.829155,-10.1878292 597.815366,64.465989 L597.815366,64.465989 L589.590624,68.6576339 L534.454392,96.714612 C448.694257,48.8789271 343.986325,49.962669 259.237241,99.5631483 C174.488158,149.163628 122.365157,239.867184 122.235742,337.97082 C122.240681,350.054712 123.032105,362.125506 124.605009,374.106856 L124.605009,374.106856 L589.759858,137.481739 L686.087494,88.4665365 L799,30.9328296 L799,99.9597565 L685.10594,157.93291 L630.003554,185.956085 L139.632933,435.494172 L112.318666,449.387446 L84.59824,463.517346 L-1,507.090171 L-1,438.029441 L28.0742935,423.223469 C50.2016048,411.963307 63.3887884,388.528533 61.5148079,363.796761 C60.8604389,355.255721 60.5332544,346.680878 60.5332544,338.072231 C60.5201157,210.980271 131.884595,94.6209658 245.251958,36.8896225 Z" id="Combined-Shape" fill="#FFFFFF" fill-rule="nonzero"></path>
8 |     </g>
9 | </svg>


--------------------------------------------------------------------------------
/polaris/static/polaris/form-styles/file-picker.scss:
--------------------------------------------------------------------------------
 1 | // Modified from https://codepen.io/adamlaki/details/VYpewx
 2 | .file-upload-wrapper {
 3 |   $height: 3rem;
 4 | 
 5 |   position: relative;
 6 |   width: 100%;
 7 |   height: $height;
 8 | 
 9 |   &:after {
10 |     content: attr(data-text);
11 |     position: absolute;
12 |     top: 0;
13 |     left: 0;
14 |     background: $input-color;
15 |     padding: 1rem 1.125rem;
16 |     display: block;
17 |     width: calc(100%);
18 |     pointer-events: none;
19 |     z-index: 20;
20 |     height: $height;
21 |     line-height: 1.15;
22 |     border-radius: $border-radius;
23 |     font-weight: 300;
24 |     cursor: pointer;
25 |   }
26 | 
27 |   &:hover {
28 |     &:before {
29 |       background: darken($success_0, 10%);
30 |     }
31 |   }
32 |   input {
33 |     opacity: 0;
34 |     padding: 1rem 1.125rem;
35 |     z-index: 99;
36 |     height: 1.15rem;
37 |     margin: 0;
38 |     display: block;
39 |     cursor: pointer;
40 |     width: 100%;
41 |   }
42 | }
43 | 


--------------------------------------------------------------------------------
/polaris/static/polaris/form-styles/select-list.scss:
--------------------------------------------------------------------------------
 1 | .select-list__item {
 2 |   cursor: pointer;
 3 |   margin: 0.5rem 0 0.125rem 0;
 4 |   display: flex;
 5 |   flex-direction: row;
 6 |   align-items: center;
 7 |   transition: opacity 0.3s ease-out;
 8 | 
 9 |   .select-list__body {
10 |     display: flex;
11 |     align-items: center;
12 |     transition: all 0.15s ease-out;
13 |     opacity: 0.4;
14 |   }
15 | 
16 |   & input[type="checkbox"] {
17 |     &:checked {
18 |       opacity: 1;
19 |       transform: scale(1);
20 | 
21 |       & + .select-list__body {
22 |         opacity: 1;
23 |       }
24 |     }
25 |     & + .select-list__body:hover {
26 |       opacity: 0.8;
27 | 
28 |       .select-list__icon {
29 |         transform: scale(1.05);
30 |       }
31 |     }
32 | 
33 |     -webkit-appearance: none;
34 |     -moz-appearance: none;
35 |     opacity: 0;
36 |     display: block;
37 |     width: 3rem;
38 |     height: 3rem;
39 |     background-repeat: no-repeat;
40 |     background-position: left center;
41 |   }
42 | }
43 | 
44 | .select-list__icon {
45 |   transition: transform 0.3s ease-out;
46 | }
47 | 
48 | .select-list__content {
49 |   margin-left: 2rem;
50 |   display: flex;
51 |   flex-direction: column;
52 | }
53 | 
54 | .select-list__title {
55 |   font-size: 18/16 + rem;
56 |   margin-bottom: 0.25rem;
57 | }
58 | 
59 | .select-list__description {
60 |   font-size: 13/16 + rem;
61 |   line-height: 1.5;
62 |   color: $dark_-2;
63 |   font-weight: $medium-weight;
64 | }
65 | 


--------------------------------------------------------------------------------
/polaris/static/polaris/form-styles/theme.scss:
--------------------------------------------------------------------------------
 1 | $main-typeface: "Cabin", sans-serif;
 2 | $regular-weight: 400;
 3 | $medium-weight: 500;
 4 | $bold-weight: 700;
 5 | 
 6 | $gradient-start: $dark_0;
 7 | $gradient-end: $dark_1;
 8 | 
 9 | $card-color: $alpha-dark_2;
10 | $card-color: $alpha-dark_2;
11 | $secondary-card-gradient1: $dark-gray;
12 | 
13 | $text-color: $white;
14 | 
15 | $border-radius: 0.75rem;
16 | 
17 | $input-main-color: $light_-2;
18 | $input-focus-color: $primary_0;
19 | $input-color: $alpha-dark_2;
20 | $input-placeholder-color: $dark_-2;
21 | 
22 | $radio-bullet-color: $dark_-2;
23 | $radio-bg-color: $input-color;
24 | $radio-size: 2rem;
25 | $bullet-size: 1rem;
26 | $radio-font-size: 18/16 + rem;
27 | 


--------------------------------------------------------------------------------
/polaris/static/polaris/form-styles/toggle.scss:
--------------------------------------------------------------------------------
 1 | // From https://codepen.io/mallendeo/details/eLIiG
 2 | // MIT licensed by Mauricio Allende
 3 | 
 4 | .control {
 5 |   input[type="checkbox"] {
 6 |     display: none;
 7 | 
 8 |     // add default box-sizing for this scope
 9 |     &,
10 |     &:after,
11 |     &:before,
12 |     & *,
13 |     & *:after,
14 |     & *:before,
15 |     & + .tgl-btn {
16 |       box-sizing: border-box;
17 |       &::selection {
18 |         background: none;
19 |       }
20 |     }
21 | 
22 |     + .tgl-btn {
23 |       outline: 0;
24 |       display: block;
25 |       width: 4em;
26 |       height: 2em;
27 |       position: relative;
28 |       cursor: pointer;
29 |       user-select: none;
30 |       background: $alpha-dark_-2;
31 |       border-radius: 2em;
32 |       padding: 2px;
33 |       transition: all 0.4s ease;
34 |       &:after {
35 |         border-radius: 50%;
36 |         background: $dark_1;
37 |         transition: all 0.2s ease;
38 |       }
39 | 
40 |       &:after,
41 |       &:before {
42 |         position: relative;
43 |         display: block;
44 |         content: "";
45 |         width: 50%;
46 |         height: 100%;
47 |       }
48 | 
49 |       &:after {
50 |         left: 0;
51 |       }
52 | 
53 |       &:before {
54 |         display: none;
55 |       }
56 |     }
57 | 
58 |     &:checked + .tgl-btn {
59 |       background: $success_0;
60 | 
61 |       &:after {
62 |         left: 50%;
63 |       }
64 |     }
65 |   }
66 | }
67 | 


--------------------------------------------------------------------------------
/polaris/static/polaris/progress.scss:
--------------------------------------------------------------------------------
 1 | $loader-height: 0.25rem;
 2 | 
 3 | .progress {
 4 |   margin: 1.25rem auto 2rem;
 5 |   align-self: center;
 6 |   display: block;
 7 |   height: $loader-height;
 8 |   width: 100%;
 9 |   max-width: 16.5rem;
10 |   border-radius: $loader-height;
11 |   background: linear-gradient(
12 |     90deg,
13 |     $primary_0,
14 |     rgba($primary_0, 0.1),
15 |     $primary_0
16 |   );
17 |   animation: gradientAnimation 2.5s linear infinite,
18 |     glowAnimation 2.5s linear infinite;
19 |   background-size: 200%;
20 | }
21 | 
22 | $shadow0: rgba($primary_0, 0.6);
23 | $shadow25: rgba($primary_0, 0.3);
24 | $shadow50: rgba($primary_0, 0.6);
25 | $shadow75: rgba($primary_0, 0.8);
26 | $shadow100: rgba($primary_0, 0.6);
27 | 
28 | @keyframes glowAnimation {
29 |   0% {
30 |     box-shadow: 0 0 1.25rem shadow $shadow0;
31 |     opacity: 0.9;
32 |   }
33 | 
34 |   25% {
35 |     box-shadow: 0 0 1rem shadow $shadow25;
36 |     opacity: 0.5;
37 |   }
38 | 
39 |   50% {
40 |     box-shadow: 0 0 1rem shadow $shadow50;
41 |     opacity: 0.6;
42 |   }
43 | 
44 |   75% {
45 |     box-shadow: 0 0 1.5rem shadow $shadow75;
46 |     opacity: 1;
47 |   }
48 | 
49 |   100% {
50 |     box-shadow: 0 0 1.25rem shadow $shadow100;
51 |     opacity: 0.9;
52 |   }
53 | }
54 | 
55 | @keyframes gradientAnimation {
56 |   0% {
57 |     background-position: 100% 50%;
58 |   }
59 |   50% {
60 |     background-position: 0% 50%;
61 |   }
62 |   100% {
63 |     background-position: -100% 50%;
64 |   }
65 | }
66 | 


--------------------------------------------------------------------------------
/polaris/static/polaris/reset.scss:
--------------------------------------------------------------------------------
 1 | // Sourced from https://dev.to/hankchizljaw/a-modern-css-reset-6p3
 2 | 
 3 | /* Box sizing rules */
 4 | // We've got this already
 5 | // *,
 6 | // *::before,
 7 | // *::after {
 8 | //   box-sizing: border-box;
 9 | // }
10 | 
11 | /* Remove default padding */
12 | ul[class],
13 | ol[class] {
14 |   padding: 0;
15 | }
16 | 
17 | /* Remove default margin */
18 | body,
19 | h1,
20 | h2,
21 | h3,
22 | h4,
23 | p,
24 | ul[class],
25 | ol[class],
26 | li,
27 | figure,
28 | figcaption,
29 | blockquote,
30 | dl,
31 | dd {
32 |   margin: 0;
33 | }
34 | 
35 | /* Set core body defaults */
36 | body {
37 |   min-height: 100vh;
38 |   scroll-behavior: smooth;
39 |   text-rendering: optimizeSpeed;
40 |   line-height: 1.5;
41 | }
42 | 
43 | /* Remove list styles on ul, ol elements with a class attribute */
44 | ul[class],
45 | ol[class] {
46 |   list-style: none;
47 | }
48 | 
49 | a {
50 |   color: inherit;
51 | }
52 | 
53 | /* A elements that don't have a class get default styles */
54 | a:not([class]) {
55 |   text-decoration-skip-ink: auto;
56 | }
57 | 
58 | /* Make images easier to work with */
59 | img {
60 |   max-width: 100%;
61 |   display: block;
62 | }
63 | 
64 | /* Natural flow and rhythm in articles by default */
65 | article > * + * {
66 |   margin-top: 1em;
67 | }
68 | 
69 | /* Inherit fonts for inputs and buttons */
70 | input,
71 | button,
72 | textarea,
73 | select {
74 |   font: inherit;
75 | }
76 | 
77 | /* Remove all animations and transitions for people that prefer not to see them */
78 | @media (prefers-reduced-motion: reduce) {
79 |   * {
80 |     animation-duration: 0.01ms !important;
81 |     animation-iteration-count: 1 !important;
82 |     transition-duration: 0.01ms !important;
83 |     scroll-behavior: auto !important;
84 |   }
85 | }
86 | 


--------------------------------------------------------------------------------
/polaris/static/polaris/scripts/callback.js:
--------------------------------------------------------------------------------
  1 | "use strict";
  2 | 
  3 | function callback({
  4 |   txJSON,
  5 |   onChangeCallback,
  6 |   transactionStatus,
  7 |   callback,
  8 | }) {
  9 |   if (onChangeCallback === 'None')
 10 |     onChangeCallback = '';
 11 |   let url = new URL(window.location);
 12 |   let currentStatus = transactionStatus;
 13 |   let isInitialLoad = url.searchParams.get('initialLoad');
 14 |   let lastStatusChange = url.searchParams.get('lastStatusChange');
 15 |   if (isInitialLoad || (lastStatusChange && lastStatusChange !== currentStatus)) {
 16 |     if (onChangeCallback.toLowerCase() === 'postmessage') {
 17 |       postMessageCallback({
 18 |         onChange: true
 19 |       });
 20 |     } else if (onChangeCallback && isInitialLoad) {
 21 |       urlCallback({
 22 |         onChange: true
 23 |       });
 24 |     }
 25 |   } else {
 26 |     updateURLForOnChangeStatus();
 27 |   }
 28 | 
 29 |   if (callback.toLowerCase() === 'postmessage') {
 30 |     postMessageCallback({
 31 |       onChange: false
 32 |     });
 33 |   } else if (callback) {
 34 |     urlCallback({
 35 |       onChange: false
 36 |     });
 37 |   }
 38 | 
 39 |   // Callback function to post the serialized transaction to the wallet.
 40 |   function postMessageCallback({
 41 |     onChange
 42 |   }) {
 43 |     let targetWindow;
 44 | 
 45 |     if (window.opener != void 0) {
 46 |       targetWindow = window.opener;
 47 |     } else if (window.parent != void 0) {
 48 |       targetWindow = window.parent;
 49 |     } else {
 50 |       return;
 51 |     }
 52 | 
 53 |     targetWindow.postMessage(JSON.parse(txJSON), "*");
 54 |     if (onChange) {
 55 |       updateURLForOnChangeStatus();
 56 |     } else {
 57 |       updateURLWithCallbackSuccess();
 58 |     }
 59 |   }
 60 | 
 61 |   // Callback function to post the serialized transaction to the callback URL
 62 |   function urlCallback({
 63 |     onChange
 64 |   }) {
 65 |     let url = onChange ? onChangeCallback : callback;
 66 |     fetch(url, {
 67 |       method: 'POST',
 68 |       headers: {
 69 |         'Content-Type': 'application/json'
 70 |       },
 71 |       body: JSON.stringify(txJSON)
 72 |     }).catch((e) => {
 73 |       console.error(`POST request to ${url} failed.`, e);
 74 |     }).then((response) => {
 75 |       if (!response.ok) {
 76 |         console.error(`POST request to ${url} failed.`, response);
 77 |         return;
 78 |       }
 79 |       if (onChange) {
 80 |         updateURLForOnChangeStatus();
 81 |       } else {
 82 |         updateURLWithCallbackSuccess();
 83 |       }
 84 |     });
 85 |   }
 86 | 
 87 |   function updateURLWithCallbackSuccess() {
 88 |     let url = new URL(window.location);
 89 |     url.searchParams.set("callback", "success");
 90 |     if (isInitialLoad) {
 91 |       url.searchParams.delete("initialLoad");
 92 |     }
 93 |     window.history.replaceState({}, '', url);
 94 |   }
 95 | 
 96 |   function updateURLForOnChangeStatus() {
 97 |     let url = new URL(window.location);
 98 |     if (isInitialLoad) {
 99 |       url.searchParams.delete("initialLoad");
100 |       window.history.replaceState({}, '', url);
101 |     }
102 |     if (onChangeCallback.toLowerCase() === 'postmessage') {
103 |       url.searchParams.set("lastStatusChange", currentStatus);
104 |       window.history.replaceState({}, '', url);
105 |     }
106 |   }
107 | }


--------------------------------------------------------------------------------
/polaris/static/polaris/scripts/disableSubmitOnClick.js:
--------------------------------------------------------------------------------
 1 | "use strict";
 2 | 
 3 | // Disable form submit buttons after first click
 4 | let submitButton = document.querySelector('.submit');
 5 | let anchorForm = document.querySelector('form');
 6 | if (anchorForm) {
 7 |   anchorForm.addEventListener('submit', (e) => {
 8 |     submitButton.disabled = true;
 9 |   });
10 | }
11 | 


--------------------------------------------------------------------------------
/polaris/static/polaris/scripts/dynamicAmountPadding.js:
--------------------------------------------------------------------------------
 1 | "use strict";
 2 | 
 3 | // Amount symbol padding
 4 | const amountSymbol = document.querySelector('.icon-symbol');
 5 | let style, width, paddingRight, amountInputElem;
 6 | if (amountSymbol) {
 7 |   style = getComputedStyle(amountSymbol);
 8 |   width = parseFloat(style.width.replace(/px/, ''));
 9 |   paddingRight = parseFloat(style.paddingRight.replace(/px/, ''));
10 |   amountInputElem = amountSymbol.nextElementSibling;
11 |   amountInputElem.style.paddingLeft = (width + paddingRight).toString() + 'px';
12 | }
13 | 


--------------------------------------------------------------------------------
/polaris/static/polaris/scripts/timezone.js:
--------------------------------------------------------------------------------
 1 | "use strict";
 2 | 
 3 | function fetchTimezone({tzEndpoint, sessionId, sessionOffset }) {
 4 |   if (!(tzEndpoint && sessionId))
 5 |     return;
 6 |   const currentOffset = new Date().getTimezoneOffset() * -1;
 7 |   if (currentOffset == sessionOffset)
 8 |     return;
 9 |   fetch(tzEndpoint, {
10 |     method: "POST",
11 |     headers: {
12 |       "Content-Type": "application/json"
13 |     },
14 |     body: JSON.stringify({
15 |       sessionId: sessionId,
16 |       sessionOffset: currentOffset
17 |     })
18 |   });
19 | }
20 | 


--------------------------------------------------------------------------------
/polaris/templates/__init__.py:
--------------------------------------------------------------------------------
1 | import enum
2 | 
3 | 
4 | class Template(enum.Enum):
5 |     MORE_INFO = 1
6 |     DEPOSIT = 2
7 |     WITHDRAW = 3
8 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/attrs.html:
--------------------------------------------------------------------------------
1 | {% for name, value in widget.attrs.items %}{% if value is not False %} {{ name }}{% if value is not True %}="{{ value|stringformat:'s' }}"{% endif %}{% endif %}{% endfor %}


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/checkbox.html:
--------------------------------------------------------------------------------
1 | <input class="form-control {{widget.class}}" type="checkbox" name="{{ widget.name }}" placeholder="" {% if widget.value != None %} value="{{ widget.value|stringformat:'s' }}" {% endif %} {% include "django/forms/widgets/attrs.html" %} >
2 | <div class="tgl-btn"></div>
3 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/checkbox_option.html:
--------------------------------------------------------------------------------
1 | {% include "django/forms/widgets/input_option.html" %}
2 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/checkbox_select.html:
--------------------------------------------------------------------------------
1 | {% include "django/forms/widgets/multiple_input.html" %}
2 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/clearable_file_input.html:
--------------------------------------------------------------------------------
1 | {% load i18n %}
2 | <div class="file-upload-wrapper" data-text="{% trans 'Select a file' %}">
3 |   <input type="file" class="file-upload-field" value="" class="form-control {{widget.class}}" type="{{ widget.type }}" name="{{ widget.name }}" {% include "django/forms/widgets/attrs.html" %} />
4 | </div>
5 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/date.html:
--------------------------------------------------------------------------------
1 | <input class="form-control date" type="text" name="{{ widget.name }}" placeholder="" {% if widget.value != None %} value="{{ widget.value|stringformat:'s' }}" {% endif %} {% include "django/forms/widgets/attrs.html" %} >
2 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/datetime.html:
--------------------------------------------------------------------------------
1 | <input class="form-control date-time" type="date" name="{{ widget.name }}" placeholder="" {% if widget.value != None %} value="{{ widget.value|stringformat:'s' }}" {% endif %} {% include "django/forms/widgets/attrs.html" %} >
2 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/email.html:
--------------------------------------------------------------------------------
1 | {% include "django/forms/widgets/input.html" %}
2 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/file.html:
--------------------------------------------------------------------------------
1 | {% load i18n %}
2 | <div class="file-upload-wrapper" data-text="{% trans 'Select a file' %}">
3 |   <input type="file" class="file-upload-field" value="" class="form-control {{widget.class}}" type="{{ widget.type }}" name="{{ widget.name }}" {% include "django/forms/widgets/attrs.html" %} />
4 | </div>
5 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/hidden.html:
--------------------------------------------------------------------------------
1 | {% include "django/forms/widgets/input.html" %}
2 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/input.html:
--------------------------------------------------------------------------------
1 | {% if widget.attrs.symbol %}
2 | <div class="icon icon-symbol">{{ widget.attrs.symbol }}</div>
3 | {% endif %}
4 | <input class="form-control {{widget.attrs.class}}" type="{{ widget.type }}" name="{{ widget.name }}" placeholder="{% if 'polaris-transaction-form-amount' in widget.attrs.class and widget.attrs.placeholder == None %}0{% else %}{{widget.attrs.placeholder|stringformat:'s'|default:' '}}{% endif %}" {% if widget.value != None %} value="{{ widget.value|stringformat:'s' }}" {% endif %} {% include "django/forms/widgets/attrs.html" %} >
5 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/input_option.html:
--------------------------------------------------------------------------------
1 | {% if widget.wrap_label %}<label{% if widget.attrs.id %} for="{{ widget.attrs.id }}"{% endif %}>{% endif %}{% include "django/forms/widgets/input.html" %}{% if widget.wrap_label %} {{ widget.label }}</label>{% endif %}
2 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/multiple_hidden.html:
--------------------------------------------------------------------------------
1 | {% include "django/forms/widgets/multiwidget.html" %}
2 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/multiple_input.html:
--------------------------------------------------------------------------------
1 | {% with id=widget.attrs.id %}<ul{% if id %} id="{{ id }}"{% endif %}{% if widget.attrs.class %} class="{{ widget.attrs.class }}"{% endif %}>{% for group, options, index in widget.optgroups %}{% if group %}
2 |   <li>{{ group }}<ul{% if id %} id="{{ id }}_{{ index }}"{% endif %}>{% endif %}{% for option in options %}
3 |     <li>{% include option.template_name with widget=option %}</li>{% endfor %}{% if group %}
4 |   </ul></li>{% endif %}{% endfor %}
5 | </ul>{% endwith %}
6 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/multiwidget.html:
--------------------------------------------------------------------------------
1 | {% spaceless %}{% for widget in widget.subwidgets %}{% include widget.template_name %}{% endfor %}{% endspaceless %}
2 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/number.html:
--------------------------------------------------------------------------------
1 | {% include "django/forms/widgets/input.html" %}
2 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/password.html:
--------------------------------------------------------------------------------
1 | {% include "django/forms/widgets/input.html" %}
2 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/radio.html:
--------------------------------------------------------------------------------
 1 | {% with id=widget.attrs.id %}
 2 | <div{% if id %} id="{{ id }}"{% endif %}{% if widget.attrs.class %} class="radio-list {{ widget.attrs.class }}"{% endif %}>
 3 | {% for group, options, index in widget.optgroups %}
 4 |   {% if group %}
 5 |   <div class="radio-list">
 6 |     {{ group }}
 7 |     <div class="radio-list"{% if id %} id="{{ id }}_{{ index }}"{% endif %}>
 8 |   {% endif %}
 9 |   {% for option in options %}
10 |       <div class="radio-item">
11 |         {% include option.template_name with widget=option %}
12 |       </div>
13 |   {% endfor %}
14 |   {% if group %}
15 |     </div></div>
16 |   {% endif %}
17 | {% endfor %}
18 | </div>
19 | {% endwith %}
20 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/radio_option.html:
--------------------------------------------------------------------------------
 1 | {% if widget.wrap_label %}
 2 | <label{% if widget.attrs.id %} for="{{ widget.attrs.id }}"{% endif %}>
 3 | {% endif %}
 4 |   {% include "django/forms/widgets/input.html" %}
 5 |   <div class="radio-dot"></div>
 6 | {% if widget.wrap_label %}
 7 |   {{ widget.label }}
 8 | </label>
 9 | {% endif %}
10 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/select.html:
--------------------------------------------------------------------------------
1 | <select name="{{ widget.name }}"{% include "django/forms/widgets/attrs.html" %}>{% for group_name, group_choices, group_index in widget.optgroups %}{% if group_name %}
2 |   <optgroup label="{{ group_name }}">{% endif %}{% for option in group_choices %}
3 |   {% include option.template_name with widget=option %}{% endfor %}{% if group_name %}
4 |   </optgroup>{% endif %}{% endfor %}
5 | </select>
6 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/select_date.html:
--------------------------------------------------------------------------------
1 | {% include 'django/forms/widgets/multiwidget.html' %}
2 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/select_option.html:
--------------------------------------------------------------------------------
1 | <option value="{{ widget.value|stringformat:'s' }}"{% include "django/forms/widgets/attrs.html" %}>{{ widget.label }}</option>
2 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/splitdatetime.html:
--------------------------------------------------------------------------------
1 | {% include 'django/forms/widgets/multiwidget.html' %}
2 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/splithiddendatetime.html:
--------------------------------------------------------------------------------
1 | {% include 'django/forms/widgets/multiwidget.html' %}
2 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/text.html:
--------------------------------------------------------------------------------
1 | {% include "django/forms/widgets/input.html" %}
2 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/textarea.html:
--------------------------------------------------------------------------------
1 | <textarea name="{{ widget.name }}"{% include "django/forms/widgets/attrs.html" %}>
2 | {% if widget.value %}{{ widget.value }}{% endif %}</textarea>
3 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/time.html:
--------------------------------------------------------------------------------
1 | <input class="form-control time" type="date" name="{{ widget.name }}" placeholder="" {% if widget.value != None %} value="{{ widget.value|stringformat:'s' }}" {% endif %} {% include "django/forms/widgets/attrs.html" %} >
2 | 


--------------------------------------------------------------------------------
/polaris/templates/django/forms/widgets/url.html:
--------------------------------------------------------------------------------
1 | {% include "django/forms/widgets/input.html" %}
2 | 


--------------------------------------------------------------------------------
/polaris/templates/polaris/base.html:
--------------------------------------------------------------------------------
 1 | {% load static %} {% load i18n %}
 2 | {% get_current_language as LANGUAGE_CODE %}
 3 | <!DOCTYPE html>
 4 | <html>
 5 |   <head>
 6 |     <meta charset="utf-8" />
 7 |     <meta name="viewport" content="width=device-width, initial-scale=1" />
 8 | 
 9 |     {% block "title" %}
10 |     <title>{% if title %}{{ title|safe }}{% else %}{% trans "SEP24 reference server" %}{% endif %}</title>
11 |     {% endblock %}
12 | 
13 |     <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Cabin&display=swap">
14 |     <link rel="stylesheet" href="{% static 'polaris/base.css' %}" />
15 |     <style>
16 |       {% comment %}
17 |       Due to the static image, can't put the background in .scss
18 |       {% endcomment %}
19 |       .control select:not([multiple]) {
20 |         background-image: url("{% static "polaris/chevron-down.svg" %}");
21 |         background-repeat: no-repeat;
22 |         background-position: right 1em top 50%, 0 0;
23 |       }
24 |     </style>
25 | 
26 |     {% block "extra_head" %}
27 |     {% endblock %}
28 |   </head>
29 |   <body>
30 |     {% block "header" %}
31 |     <nav class="navbar" role="navigation" aria-label="main navigation">
32 |       <div class="navbar-brand">
33 |         {% if icon_path %}
34 |         <img class="logo" src="{% static icon_path %}" alt="" />
35 |         {% elif org_logo_url %}
36 |         <img class="logo" src="{{ org_logo_url }}" alt="" />
37 |         {% else %}
38 |         <img class="logo" src="{% static 'polaris/company-icon.svg' %}" alt="" />
39 |         {% endif %}
40 |         {% if icon_label %}
41 |         <a class="title" href="#">
42 |             {{ icon_label|safe }}
43 |         </a>
44 |         {% endif %}
45 |       </div>
46 |     </nav>
47 |     {% endblock %}
48 |     <div class="main-content">
49 |       {% block "content" %}
50 |       {% endblock %}
51 |     </div>
52 | 
53 |     {# Rendered via custom extra_body template #}
54 |     {% block "extra_body" %}
55 |     {% endblock %}
56 | 
57 |     <div class="bottom section">
58 |       {% block "footer" %}
59 |       {% endblock %}
60 |     </div>
61 | 
62 |     {% block "body_scripts" %}
63 |     <script type="text/javascript" src="{% static 'polaris/scripts/number.js' %}"></script>
64 |     <script type="text/javascript" src="{% static 'polaris/scripts/styleHelpers.js' %}"></script>
65 |     <script type="text/javascript" src="{% static 'polaris/scripts/disableSubmitOnClick.js' %}"></script>
66 |     <script type="text/javascript" src="{% static 'polaris/scripts/dynamicAmountPadding.js' %}"></script>
67 |     <script type="text/javascript" src="{% static 'polaris/scripts/feeTable.js' %}"></script>
68 |     <script type="text/javascript" src="{% static 'polaris/scripts/timezone.js' %}"></script>
69 |     <script type="text/javascript">
70 |       styleHelpers({
71 |         languageCode: "{{ LANGUAGE_CODE }}"
72 |       });
73 |       feeTable({
74 |         operation: "{{ operation }}",
75 |         additiveFeesEnabled: "{{ additive_fees_enabled }}" === "True",
76 |         depositFeeFixed: {{ asset.deposit_fee_fixed|default:0 }},
77 |         depositFeePercent: {{ asset.deposit_fee_percent|default:0 }},
78 |         withdrawalFeeFixed: {{ asset.withdrawal_fee_fixed|default:0 }},
79 |         withdrawalFeePercent: {{ asset.withdrawal_fee_percent|default:0 }},
80 |         significantDecimals: {{ asset.significant_decimals|default:2 }},
81 |         symbol: "{{ symbol }}",
82 |         assetCode: "{{ asset.code }}",
83 |         useFeeEndpoint: "{{ use_fee_endpoint }}" === "True",
84 |         languageCode: "{{ LANGUAGE_CODE }}",
85 |         parseNumber: parseNumber,
86 |         formatNumber: formatNumber,
87 |         showFeeTable: "{{ show_fee_table }}" === "True"
88 |       });
89 |       fetchTimezone({
90 |         tzEndpoint: "{{ timezone_endpoint }}",
91 |         sessionId: "{{ session_id }}",
92 |         sessionOffset: {{ current_offset|default:0 }}
93 |       });
94 |     </script>
95 |     {% endblock "body_scripts" %}
96 |   </body>
97 | </html>
98 | 


--------------------------------------------------------------------------------
/polaris/templates/polaris/deposit.html:
--------------------------------------------------------------------------------
 1 | {% extends "./base.html" %} {% load i18n %}
 2 | 
 3 | {% block "title" %}
 4 | <title>{% if title %} {{ title|safe }} {% else %} {% trans "Interactive Deposit Info Form" %} {% endif %}</title>
 5 | {% endblock %}
 6 | 
 7 | 
 8 | {% block "content" %}
 9 | <section class="section">
10 |   {% block "guidance" %}
11 |   {% if guidance %}
12 |     <center><i>{{ guidance|safe }}</i></center>
13 |   {% else %}
14 |     <center><i>{% trans "Please fill out the fields below." %}</i></center>
15 |   {% endif %}
16 |   {% endblock %}
17 | 
18 |   {% block "form" %}
19 |   <form method="post" action="{{ post_url }}">
20 |     {% csrf_token %}
21 | 
22 |     {% for hidden in form.hidden_fields %}
23 |     {{ hidden }}
24 |     {% endfor %}
25 | 
26 |     {% for field in form.visible_fields %}
27 |     <div class="field">
28 |       <div class="label">
29 |         {{ field.label }}
30 |         {% if field.field.required %}
31 |         <span class="required">*</span>
32 |         {% endif %}
33 |       </div>
34 | 
35 |       <div class="control">{{ field }}</div>
36 |       {% if field.help_text %}
37 |         <div class="help-text">{{ field.help_text }}</div>
38 |       {% endif %}
39 | 
40 |       {% if field.errors %}
41 |       <p class="help is-danger">
42 |         {% for error in field.errors %}
43 |         {{ error }}
44 |         {% endfor %}
45 |       </p>
46 |       {% endif %}
47 |     </div>
48 |     {% endfor %}
49 | 
50 |     {% block "fee_table" %}
51 |     <table class="polaris-fee-table" hidden>
52 |       <tr class="polaris-fee-row"><td class="polaris-fee-label">{% trans "Fee" %}</td><td class="polaris-fee-value">{{ symbol }} 0</td></tr>
53 |       <tr class="polaris-fee-total-row"><td class="polaris-fee-total-label">{% trans "Total" %}</td><td class="polaris-fee-total-value">{{ symbol }} 0</td></tr>
54 |     </table>
55 |     {% endblock %}
56 | 
57 |     <div class="field at-bottom">
58 |       <div class="control">
59 |         <button class="button submit" type="submit">{% trans "Submit" %}</button>
60 |       </div>
61 |     </div>
62 | 
63 |   </form>
64 |   {% endblock %}
65 | </section>
66 | {% endblock %}
67 | 


--------------------------------------------------------------------------------
/polaris/templates/polaris/error.html:
--------------------------------------------------------------------------------
 1 | {% extends "./base.html" %} {% load i18n %}
 2 | 
 3 | {% block "title" %}
 4 | <title>{% if title %} {{ title|safe }} {% else %} {% blocktrans %}Error: {{ status_code }}{% endblocktrans %} {% endif %}</title>
 5 | {% endblock %}
 6 | 
 7 | {% block "content" %}
 8 | <section class="section">
 9 |     <h2>{% blocktrans %}Error: {{ status_code }}{% endblocktrans %}</h2>
10 |     <p>{{ error }}</p>
11 | </section>
12 | {% endblock %}
13 | 


--------------------------------------------------------------------------------
/polaris/templates/polaris/widgets/card_cvv.html:
--------------------------------------------------------------------------------
1 | <input type="tel" maxlength="4" class="cc-cvv" inputmode="numeric" placeholder=" " name="{{ widget.name }}" {% include "django/forms/widgets/attrs.html" %}>
2 | 


--------------------------------------------------------------------------------
/polaris/templates/polaris/widgets/card_expiration.html:
--------------------------------------------------------------------------------
1 | <input type="tel" maxlength="5" class="cc-expiration" inputmode="numeric" placeholder=" " name="{{ widget.name }}" {% include "django/forms/widgets/attrs.html" %}>
2 | 


--------------------------------------------------------------------------------
/polaris/templates/polaris/widgets/card_number.html:
--------------------------------------------------------------------------------
1 | <input type="tel" maxlength="19" class="cc-number" inputmode="numeric" placeholder=" " name="{{ widget.name }}" {% include "django/forms/widgets/attrs.html" %}>
2 | 


--------------------------------------------------------------------------------
/polaris/templates/polaris/withdraw.html:
--------------------------------------------------------------------------------
 1 | {% extends "./base.html" %} {% load i18n %}
 2 | 
 3 | {% block "title" %}
 4 | <title>{% if title %} {{ title|safe }} {% else %} {% trans "Interactive Withdraw Info Form" %} {% endif %}</title>
 5 | {% endblock %}
 6 | 
 7 | 
 8 | {% block "content" %}
 9 | <section class="section">
10 |   {% block "guidance" %}
11 |   {% if guidance %}
12 |     <center><i>{{ guidance|safe }}</i></center>
13 |   {% else %}
14 |     <center><i>{% trans "Please fill out the fields below." %}</i></center>
15 |   {% endif %}
16 |   {% endblock %}
17 | 
18 |   {% block "form" %}
19 |   <form method="post" action="{{ post_url }}">
20 |     {% csrf_token %}
21 | 
22 |     {% for hidden in form.hidden_fields %}
23 |     {{ hidden }}
24 |     {% endfor %}
25 | 
26 |     {% for field in form.visible_fields %}
27 |     <div class="field">
28 |       <div class="label">
29 |         {{ field.label }}
30 |         {% if field.field.required %}
31 |         <span class="required">*</span>
32 |         {% endif %}
33 |       </div>
34 | 
35 |       <div class="control">{{ field }}</div>
36 |       {% if field.help_text %}
37 |         <div class="help-text">{{ field.help_text }}</div>
38 |       {% endif %}
39 | 
40 |       {% if field.errors %}
41 |       <p class="help is-danger">
42 |         {% for error in field.errors %}
43 |         {{ error }}
44 |         {% endfor %}
45 |       </p>
46 |       {% endif %}
47 |     </div>
48 |     {% endfor %}
49 | 
50 |     {% block "fee_table" %}
51 |     <table class="polaris-fee-table" hidden>
52 |       <tr class="polaris-fee-row"><td class="polaris-fee-label">{% trans "Fee" %}</td><td class="polaris-fee-value">{{ symbol }} 0</td></tr>
53 |       <tr class="polaris-fee-total-row"><td class="polaris-fee-total-label">{% trans "Total" %}</td><td class="polaris-fee-total-value">{{ symbol }} 0</td></tr>
54 |     </table>
55 |     {% endblock %}
56 | 
57 |     <div class="field at-bottom">
58 |       <div class="control">
59 |         <button class="button submit" type="submit">{% trans "Submit" %}</button>
60 |       </div>
61 |     </div>
62 | 
63 |   </form>
64 |   {% endblock %}
65 | </section>
66 | {% endblock %}
67 | 


--------------------------------------------------------------------------------
/polaris/tests/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/tests/__init__.py


--------------------------------------------------------------------------------
/polaris/tests/commands/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/tests/commands/__init__.py


--------------------------------------------------------------------------------
/polaris/tests/helpers.py:
--------------------------------------------------------------------------------
  1 | """Helper functions to use across tests."""
  2 | import json
  3 | import time
  4 | from unittest.mock import Mock
  5 | 
  6 | from polaris import settings
  7 | from stellar_sdk.keypair import Keypair
  8 | from stellar_sdk.transaction_envelope import TransactionEnvelope
  9 | 
 10 | TEST_MUXED_ACCOUNT = (
 11 |     "MDOP36XYBRBRAFHGRP7VPH335XVEQLSCF2UA7PT34TTZOXFMIGJJWAAAAAAAAAAAPMYT4"
 12 | )
 13 | TEST_ACCOUNT_MEMO = 123
 14 | 
 15 | 
 16 | def mock_check_auth_success(request, func, **kwargs):
 17 |     """Mocks `sep10.utils.check_auth`, for success."""
 18 |     return func(
 19 |         Mock(
 20 |             account="test source address",
 21 |             muxed_account=None,
 22 |             memo=None,
 23 |             client_domain=None,
 24 |         ),
 25 |         request,
 26 |         **kwargs,
 27 |     )
 28 | 
 29 | 
 30 | def mock_check_auth_success_muxed_account(request, func, **kwargs):
 31 |     """Mocks `sep10.utils.check_auth`, for success."""
 32 | 
 33 |     return func(
 34 |         Mock(
 35 |             account="GDOP36XYBRBRAFHGRP7VPH335XVEQLSCF2UA7PT34TTZOXFMIGJJXHS5",
 36 |             muxed_account=TEST_MUXED_ACCOUNT,
 37 |             memo=None,
 38 |             client_domain=None,
 39 |         ),
 40 |         request,
 41 |         **kwargs,
 42 |     )
 43 | 
 44 | 
 45 | def mock_check_auth_success_with_memo(request, func, **kwargs):
 46 |     """Mocks `sep10.utils.check_auth`, for success."""
 47 | 
 48 |     return func(
 49 |         Mock(
 50 |             account="test source address",
 51 |             muxed_account=None,
 52 |             memo=TEST_ACCOUNT_MEMO,
 53 |             client_domain=None,
 54 |         ),
 55 |         request,
 56 |         **kwargs,
 57 |     )
 58 | 
 59 | 
 60 | def mock_check_auth_success_client_domain(request, func, **kwargs):
 61 |     """Mocks `sep10.utils.check_auth`, for success."""
 62 |     return func(
 63 |         Mock(
 64 |             account="test source address",
 65 |             muxed_account=None,
 66 |             memo=None,
 67 |             client_domain="test.com",
 68 |         ),
 69 |         request,
 70 |         **kwargs,
 71 |     )
 72 | 
 73 | 
 74 | def sep10(client, address, seed):
 75 |     response = client.get(f"/auth?account={address}", follow=True)
 76 |     content = json.loads(response.content)
 77 |     envelope_xdr = content["transaction"]
 78 |     envelope_object = TransactionEnvelope.from_xdr(
 79 |         envelope_xdr, network_passphrase=settings.STELLAR_NETWORK_PASSPHRASE
 80 |     )
 81 |     client_signing_key = Keypair.from_secret(seed)
 82 |     envelope_object.sign(client_signing_key)
 83 |     client_signed_envelope_xdr = envelope_object.to_xdr()
 84 | 
 85 |     response = client.post(
 86 |         "/auth",
 87 |         data={"transaction": client_signed_envelope_xdr},
 88 |         content_type="application/json",
 89 |     )
 90 |     content = json.loads(response.content)
 91 |     encoded_jwt = content["token"]
 92 |     assert encoded_jwt
 93 |     return encoded_jwt
 94 | 
 95 | 
 96 | def interactive_jwt_payload(transaction, transaction_type):
 97 |     current_time = time.time()
 98 |     return {
 99 |         "iss": f"http://testserver/sep24/transactions/{transaction_type}/interactive",
100 |         "exp": current_time + 35,
101 |         "iat": current_time - 5,
102 |         "jti": str(transaction.id),
103 |         "sub": transaction.stellar_account,
104 |     }
105 | 


--------------------------------------------------------------------------------
/polaris/tests/sep1/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/tests/sep1/__init__.py


--------------------------------------------------------------------------------
/polaris/tests/sep1/test_toml.py:
--------------------------------------------------------------------------------
 1 | from unittest.mock import patch, Mock
 2 | 
 3 | import toml
 4 | import pytest
 5 | from stellar_sdk import Keypair
 6 | from rest_framework.request import Request
 7 | 
 8 | from polaris import settings
 9 | from polaris.models import Asset
10 | 
11 | TOML_PATH = "/.well-known/stellar.toml"
12 | TEST_MODULE = "polaris.sep1.views"
13 | 
14 | 
15 | @pytest.mark.django_db
16 | @patch(f"{TEST_MODULE}.registered_toml_func")
17 | def test_toml_generated(mock_toml_func, client):
18 |     usd = Asset.objects.create(
19 |         code="USD",
20 |         issuer=Keypair.random().public_key,
21 |         distribution_seed=Keypair.random().secret,
22 |     )
23 |     with patch(
24 |         f"{TEST_MODULE}.settings.ACTIVE_SEPS",
25 |         ["sep-1", "sep-6", "sep-10", "sep-12", "sep-24", "sep-31", "sep-38"],
26 |     ):
27 |         response = client.get(TOML_PATH)
28 |     assert response.status_code == 200
29 |     assert response.content_type == "text/plain"
30 |     assert mock_toml_func.was_called_once()
31 |     assert isinstance(mock_toml_func.call_args[0][0], Request)
32 | 
33 |     toml_data = toml.loads(response.content.decode())
34 |     assert "NETWORK_PASSPHRASE" in toml_data
35 |     assert "ACCOUNTS" in toml_data
36 |     assert "TRANSFER_SERVER" in toml_data
37 |     assert "TRANSFER_SERVER_SEP0024" in toml_data
38 |     assert "WEB_AUTH_ENDPOINT" in toml_data
39 |     assert "SIGNING_KEY" in toml_data
40 |     assert "KYC_SERVER" in toml_data
41 |     assert "DIRECT_PAYMENT_SERVER" in toml_data
42 |     assert "ANCHOR_QUOTE_SERVER" in toml_data
43 |     assert toml_data["TRANSFER_SERVER"] != toml_data["TRANSFER_SERVER_SEP0024"]
44 |     assert toml_data["ACCOUNTS"] == [usd.distribution_account]
45 |     assert toml_data["NETWORK_PASSPHRASE"] == settings.STELLAR_NETWORK_PASSPHRASE
46 |     assert toml_data["SIGNING_KEY"] == settings.SIGNING_KEY
47 | 
48 | 
49 | @patch(f"{TEST_MODULE}.finders.find")
50 | @patch(f"{TEST_MODULE}.open")
51 | def test_toml_static(mock_open, mock_find, client):
52 |     mock_find.return_value = "test.toml"
53 |     mock_open.return_value = Mock(
54 |         __enter__=Mock(
55 |             return_value=Mock(read=Mock(return_value="TEST_ATTR=1".encode()))
56 |         ),
57 |         __exit__=Mock(),
58 |     )
59 |     response = client.get(TOML_PATH)
60 | 
61 |     assert response.status_code == 200
62 |     assert response.content_type == "text/plain"
63 |     mock_find.assert_called_once_with("polaris/stellar.toml")
64 |     mock_open.assert_called_once()
65 | 
66 |     toml_data = toml.loads(response.content.decode())
67 |     assert toml_data == {"TEST_ATTR": 1}
68 | 
69 | 
70 | @patch(f"{TEST_MODULE}.finders.find")
71 | @patch(f"{TEST_MODULE}.open")
72 | @patch(f"{TEST_MODULE}.settings.LOCAL_MODE", True)
73 | def test_toml_static_local_mode(mock_open, mock_find, client):
74 |     mock_find.return_value = "test.toml"
75 |     mock_open.return_value = Mock(
76 |         __enter__=Mock(
77 |             return_value=Mock(read=Mock(return_value="TEST_ATTR=1".encode()))
78 |         ),
79 |         __exit__=Mock(),
80 |     )
81 |     response = client.get(TOML_PATH)
82 | 
83 |     assert response.status_code == 200
84 |     assert response.content_type == "text/plain"
85 |     mock_find.assert_called_once_with("polaris/local-stellar.toml")
86 |     mock_open.assert_called_once()
87 | 
88 |     toml_data = toml.loads(response.content.decode())
89 |     assert toml_data == {"TEST_ATTR": 1}
90 | 


--------------------------------------------------------------------------------
/polaris/tests/sep10/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/tests/sep10/__init__.py


--------------------------------------------------------------------------------
/polaris/tests/sep12/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/tests/sep12/__init__.py


--------------------------------------------------------------------------------
/polaris/tests/sep24/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/tests/sep24/__init__.py


--------------------------------------------------------------------------------
/polaris/tests/sep24/test_info.py:
--------------------------------------------------------------------------------
 1 | """This module tests the `/info` endpoint."""
 2 | import json
 3 | import pytest
 4 | 
 5 | 
 6 | def _get_expected_response():
 7 |     return """
 8 |         {
 9 |             "deposit": {
10 |                 "USD": {
11 |                     "enabled": true,
12 |                     "min_amount": 0.1,
13 |                     "max_amount": 1000.0,
14 |                     "fee_fixed": 5.0,
15 |                     "fee_percent": 1.0
16 |                 },
17 |                 "ETH": {
18 |                     "enabled": true,
19 |                     "max_amount": 10000000.0,
20 |                     "fee_fixed": 0.002,
21 |                     "fee_percent": 0.0
22 |                 }
23 |             },
24 |             "withdraw": {
25 |                 "USD": {
26 |                     "enabled": true,
27 |                     "min_amount": 0.1,
28 |                     "max_amount": 1000.0,
29 |                     "fee_fixed": 5.0,
30 |                     "fee_percent": 0.0
31 |                 },
32 |                 "ETH": {
33 |                     "enabled": false
34 |                 }
35 |             },
36 |             "fee": {
37 |                 "enabled": true
38 |             },
39 |             "features": {
40 |                 "account_creation": true,
41 |                 "claimable_balances": true
42 |             }
43 |         }
44 |     """
45 | 
46 | 
47 | @pytest.mark.django_db
48 | def test_info_endpoint(client, usd_asset_factory, eth_asset_factory):
49 |     """
50 |     Ensures the /info endpoint provides data in the expected format, according to
51 |     SEP 24: https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0024.md
52 |     """
53 |     usd_asset_factory()
54 |     eth_asset_factory()
55 | 
56 |     response = client.get(f"/sep24/info", follow=True)
57 |     content = json.loads(response.content)
58 |     expected_response = json.loads(_get_expected_response())
59 |     assert content == expected_response
60 |     assert response.status_code == 200
61 | 


--------------------------------------------------------------------------------
/polaris/tests/sep24/test_tzinfo.py:
--------------------------------------------------------------------------------
 1 | from uuid import uuid4
 2 | from datetime import datetime, timedelta, timezone
 3 | 
 4 | import pytest
 5 | import pytz
 6 | from django.urls import reverse
 7 | from django.contrib.sessions.models import Session
 8 | 
 9 | 
10 | @pytest.mark.django_db
11 | def test_successful_post(client):
12 |     suuid = str(uuid4())
13 |     session = Session.objects.create(
14 |         session_key=suuid,
15 |         session_data='{"test":"test"}',
16 |         expire_date=datetime.now(timezone.utc) + timedelta(hours=1),
17 |     )
18 | 
19 |     response = client.post(
20 |         reverse("tzinfo"),
21 |         {"sessionId": session.session_key, "sessionOffset": 0},
22 |         content_type="application/json",
23 |     )
24 | 
25 |     assert response.status_code == 200, response.content
26 |     assert response.json().get("status") == "ok"
27 | 
28 |     session.refresh_from_db()
29 |     tz = session.get_decoded().get("timezone")
30 |     assert tz
31 |     assert datetime.now(timezone.utc).astimezone(
32 |         pytz.timezone(tz)
33 |     ).utcoffset() == timedelta(minutes=0)
34 | 
35 | 
36 | @pytest.mark.django_db
37 | def test_missing_parameters(client):
38 |     suuid = str(uuid4())
39 |     session = Session.objects.create(
40 |         session_key=suuid,
41 |         session_data='{"test":"test"}',
42 |         expire_date=datetime.now(timezone.utc) + timedelta(hours=1),
43 |     )
44 | 
45 |     response = client.post(
46 |         reverse("tzinfo"),
47 |         {
48 |             "sessionId": session.session_key,
49 |         },
50 |         content_type="application/json",
51 |     )
52 | 
53 |     assert response.status_code == 400, response.content
54 |     assert response.json().get("error") == "missing required parameters"
55 | 
56 | 
57 | @pytest.mark.django_db
58 | def test_no_timezone_match(client):
59 |     suuid = str(uuid4())
60 |     session = Session.objects.create(
61 |         session_key=suuid,
62 |         session_data='{"test":"test"}',
63 |         expire_date=datetime.now(timezone.utc) + timedelta(hours=1),
64 |     )
65 | 
66 |     response = client.post(
67 |         reverse("tzinfo"),
68 |         {"sessionId": session.session_key, "sessionOffset": -1000},
69 |         content_type="application/json",
70 |     )
71 | 
72 |     assert response.status_code == 400, response.content
73 |     assert response.json().get("error") == "no timezones matched with offset"
74 | 


--------------------------------------------------------------------------------
/polaris/tests/sep31/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/tests/sep31/__init__.py


--------------------------------------------------------------------------------
/polaris/tests/sep31/test_poll_outgoing_transactions.py:
--------------------------------------------------------------------------------
 1 | import pytest
 2 | from datetime import datetime
 3 | from unittest.mock import Mock, patch
 4 | 
 5 | from polaris.models import Transaction
 6 | from polaris.management.commands.poll_outgoing_transactions import Command
 7 | 
 8 | 
 9 | mock_return_passed_transactions = Mock(poll_outgoing_transactions=lambda x: list(x))
10 | 
11 | 
12 | @pytest.mark.django_db
13 | @patch(
14 |     "polaris.management.commands.poll_outgoing_transactions.rri",
15 |     mock_return_passed_transactions,
16 | )
17 | def test_ready_transaction(acc1_usd_deposit_transaction_factory):
18 |     transaction = acc1_usd_deposit_transaction_factory(
19 |         protocol=Transaction.PROTOCOL.sep31
20 |     )
21 |     transaction.status = Transaction.STATUS.pending_external
22 |     transaction.save()
23 |     Command.poll_outgoing_transactions()
24 |     transaction.refresh_from_db()
25 |     assert transaction.status == Transaction.STATUS.completed
26 |     assert isinstance(transaction.completed_at, datetime)
27 | 
28 | 
29 | @pytest.mark.django_db
30 | @patch(
31 |     "polaris.management.commands.poll_outgoing_transactions.rri",
32 |     Mock(poll_outgoing_transactions=Mock(side_effect=ValueError())),
33 | )
34 | def test_error_raised_in_integration(acc1_usd_deposit_transaction_factory):
35 |     transaction = acc1_usd_deposit_transaction_factory(
36 |         protocol=Transaction.PROTOCOL.sep31
37 |     )
38 |     transaction.status = Transaction.STATUS.pending_external
39 |     transaction.save()
40 |     Command.poll_outgoing_transactions()
41 |     assert transaction.status == Transaction.STATUS.pending_external
42 |     assert not transaction.completed_at
43 | 
44 | 
45 | @pytest.mark.django_db
46 | @patch(
47 |     "polaris.management.commands.poll_outgoing_transactions.rri",
48 |     Mock(poll_outgoing_transactions=Mock(return_value=[1, 2, 3])),
49 | )
50 | def test_bad_integration_return_value(acc1_usd_deposit_transaction_factory):
51 |     transaction = acc1_usd_deposit_transaction_factory(
52 |         protocol=Transaction.PROTOCOL.sep31
53 |     )
54 |     transaction.status = Transaction.STATUS.pending_external
55 |     transaction.save()
56 |     Command.poll_outgoing_transactions()
57 |     transaction.refresh_from_db()
58 |     assert transaction.status == Transaction.STATUS.pending_external
59 |     assert not transaction.completed_at
60 | 


--------------------------------------------------------------------------------
/polaris/tests/sep38/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/tests/sep38/__init__.py


--------------------------------------------------------------------------------
/polaris/tests/sep38/test_info.py:
--------------------------------------------------------------------------------
 1 | import pytest
 2 | 
 3 | from stellar_sdk import Keypair
 4 | 
 5 | from polaris.models import Asset, OffChainAsset, DeliveryMethod
 6 | 
 7 | ENDPOINT = "/sep38/info"
 8 | 
 9 | 
10 | @pytest.mark.django_db
11 | def test_info(client):
12 |     usd_stellar = Asset.objects.create(
13 |         code="usd", issuer=Keypair.random().public_key, sep38_enabled=True
14 |     )
15 |     brl_offchain = OffChainAsset.objects.create(
16 |         scheme="iso4217", identifier="BRL", country_codes="BRA"
17 |     )
18 |     delivery_methods = [
19 |         DeliveryMethod.objects.create(
20 |             type=DeliveryMethod.TYPE.buy, name="cash_pickup", description="cash pick-up"
21 |         ),
22 |         DeliveryMethod.objects.create(
23 |             type=DeliveryMethod.TYPE.sell,
24 |             name="cash_dropoff",
25 |             description="cash drop-off",
26 |         ),
27 |     ]
28 |     brl_offchain.delivery_methods.add(*delivery_methods)
29 | 
30 |     response = client.get(ENDPOINT)
31 |     assert response.status_code == 200, response.content
32 | 
33 |     body = response.json()
34 |     assert len(body["assets"]) == 2, body
35 | 
36 |     expected_usd_stellar = {"asset": f"stellar:{usd_stellar.code}:{usd_stellar.issuer}"}
37 |     expected_brl_offchain = {
38 |         "asset": brl_offchain.asset_identification_format,
39 |         "sell_delivery_methods": [
40 |             {"name": "cash_dropoff", "description": "cash drop-off"}
41 |         ],
42 |         "buy_delivery_methods": [
43 |             {"name": "cash_pickup", "description": "cash pick-up"}
44 |         ],
45 |         "country_codes": ["BRA"],
46 |     }
47 |     for a in body["assets"]:
48 |         if a["asset"] == expected_usd_stellar["asset"]:
49 |             assert a == expected_usd_stellar, (a, expected_usd_stellar)
50 |         elif a["asset"] == brl_offchain.asset_identification_format:
51 |             assert a == expected_brl_offchain, (a, expected_brl_offchain)
52 |         else:
53 |             raise ValueError(f"unexpected asset: {a}")
54 | 


--------------------------------------------------------------------------------
/polaris/tests/sep6/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/tests/sep6/__init__.py


--------------------------------------------------------------------------------
/polaris/tests/settings.py:
--------------------------------------------------------------------------------
 1 | from settings import *
 2 | from polaris import settings
 3 | 
 4 | STORAGES = {
 5 |     "staticfiles": {
 6 |         "BACKEND": "django.contrib.staticfiles.storage.StaticFilesStorage",
 7 |     },
 8 | }
 9 | settings.LOCAL_MODE = False
10 | SESSION_COOKIE_SECURE = True
11 | INSTALLED_APPS.remove("server")
12 | ROOT_URLCONF = "polaris.urls"
13 | 


--------------------------------------------------------------------------------
/polaris/tests/shared_endpoints/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/polaris/tests/shared_endpoints/__init__.py


--------------------------------------------------------------------------------
/polaris/tests/shared_endpoints/test_more_info.py:
--------------------------------------------------------------------------------
 1 | """This module tests the `/transaction/more_info` endpoint."""
 2 | import json
 3 | import pytest
 4 | from polaris.tests.helpers import sep10
 5 | 
 6 | # Test client account and seed
 7 | client_address = "GDKFNRUATPH4BSZGVFDRBIGZ5QAFILVFRIRYNSQ4UO7V2ZQAPRNL73RI"
 8 | client_seed = "SDKWSBERDHP3SXW5A3LXSI7FWMMO5H7HG33KNYBKWH2HYOXJG2DXQHQY"
 9 | 
10 | endpoint = "/sep24/transaction/more_info"
11 | 
12 | 
13 | @pytest.mark.django_db
14 | def test_more_info_required_fields(client):
15 |     """Fails if no required fields are provided."""
16 |     response = client.get(endpoint)
17 |     assert response.status_code == 400
18 | 
19 | 
20 | @pytest.mark.django_db
21 | def test_more_info_id_filter(client, acc1_usd_deposit_transaction_factory):
22 |     """Succeeds if a valid transaction ID is provided."""
23 |     deposit = acc1_usd_deposit_transaction_factory(client_address)
24 |     response = client.get(f"{endpoint}?id={deposit.id}")
25 | 
26 |     assert response.status_code == 200
27 | 
28 | 
29 | @pytest.mark.django_db
30 | def test_more_info_stellar_filter(client, acc1_usd_deposit_transaction_factory):
31 |     """Succeeds if a valid Stellar transaction ID is provided."""
32 |     deposit = acc1_usd_deposit_transaction_factory(client_address)
33 |     deposit.stellar_transaction_id = "test_stellar_id"
34 |     deposit.save()
35 |     response = client.get(
36 |         f"{endpoint}?stellar_transaction_id={deposit.stellar_transaction_id}",
37 |     )
38 |     assert response.status_code == 200
39 | 
40 | 
41 | @pytest.mark.django_db
42 | def test_more_info_external_filter(client, acc1_usd_deposit_transaction_factory):
43 |     """Succeeds if a valid external transaction ID is provided."""
44 |     deposit = acc1_usd_deposit_transaction_factory(client_address)
45 |     response = client.get(
46 |         f"{endpoint}?external_transaction_id={deposit.external_transaction_id}",
47 |     )
48 |     assert response.status_code == 200
49 | 
50 | 
51 | @pytest.mark.django_db
52 | def test_more_info_multiple_filters(client, acc1_usd_deposit_transaction_factory):
53 |     """Succeeds if a valid combination of IDs is provided."""
54 |     deposit = acc1_usd_deposit_transaction_factory(client_address)
55 |     deposit.stellar_transaction_id = "test_stellar_id"
56 |     deposit.save()
57 |     response = client.get(
58 |         f"{endpoint}?id={deposit.id}"
59 |         f"&external_transaction_id={deposit.external_transaction_id}"
60 |         f"&stellar_transaction_id={deposit.stellar_transaction_id}",
61 |     )
62 |     assert response.status_code == 200
63 | 
64 | 
65 | @pytest.mark.django_db
66 | def test_more_info_no_result(
67 |     client,
68 |     acc1_usd_deposit_transaction_factory,
69 |     acc2_eth_withdrawal_transaction_factory,
70 | ):
71 |     """Fails if an invalid combination of IDs is provided."""
72 |     deposit = acc1_usd_deposit_transaction_factory(client_address)
73 |     withdrawal = acc2_eth_withdrawal_transaction_factory(client_address)
74 |     response = client.get(
75 |         f"{endpoint}?id={deposit.id}"
76 |         f"&external_transaction_id={withdrawal.external_transaction_id}"
77 |         f"&stellar_transaction_id={withdrawal.stellar_transaction_id}",
78 |     )
79 |     assert response.status_code == 404
80 | 


--------------------------------------------------------------------------------
/polaris/tests/test_register_integrations.py:
--------------------------------------------------------------------------------
 1 | import pytest
 2 | from unittest.mock import NonCallableMock
 3 | from polaris import integrations
 4 | from polaris.integrations import (
 5 |     register_integrations,
 6 |     DepositIntegration,
 7 |     WithdrawalIntegration,
 8 |     SEP31ReceiverIntegration,
 9 |     CustomerIntegration,
10 |     RailsIntegration,
11 | )
12 | 
13 | 
14 | def test_init_success_no_integrations():
15 |     register_integrations()
16 | 
17 | 
18 | def test_init_success_all_integrations():
19 |     deposit = DepositIntegration()
20 |     withdrawal = WithdrawalIntegration()
21 |     sep31 = SEP31ReceiverIntegration()
22 |     customer = CustomerIntegration()
23 |     rails = RailsIntegration()
24 |     callable = lambda x: None
25 |     register_integrations(
26 |         deposit=deposit,
27 |         withdrawal=withdrawal,
28 |         sep31_receiver=sep31,
29 |         customer=customer,
30 |         rails=rails,
31 |         fee=callable,
32 |         sep6_info=callable,
33 |         toml=callable,
34 |     )
35 |     assert integrations.registered_deposit_integration == deposit
36 |     assert integrations.registered_withdrawal_integration == withdrawal
37 |     assert integrations.registered_sep31_receiver_integration == sep31
38 |     assert integrations.registered_customer_integration == customer
39 |     assert integrations.registered_rails_integration == rails
40 |     assert all(
41 |         i == callable
42 |         for i in [
43 |             integrations.registered_fee_func,
44 |             integrations.registered_info_func,
45 |             integrations.registered_toml_func,
46 |         ]
47 |     )
48 | 
49 | 
50 | def test_invalid_integration_params():
51 |     for kwarg in [
52 |         "deposit",
53 |         "withdrawal",
54 |         "sep31_receiver",
55 |         "customer",
56 |         "rails",
57 |         "fee",
58 |         "sep6_info",
59 |         "toml",
60 |     ]:
61 |         with pytest.raises(TypeError):
62 |             register_integrations(**{kwarg: NonCallableMock()})
63 | 


--------------------------------------------------------------------------------
/polaris/urls.py:
--------------------------------------------------------------------------------
 1 | """app URL Configuration
 2 | 
 3 | The `urlpatterns` list routes URLs to views. For more information please see:
 4 |     https://docs.djangoproject.com/en/2.2/topics/http/urls/
 5 | Examples:
 6 | Function views
 7 |     1. Add an import:  from my_app import views
 8 |     2. Add a URL to urlpatterns:  path('', views.home, name='home')
 9 | Class-based views
10 |     1. Add an import:  from other_app.views import Home
11 |     2. Add a URL to urlpatterns:  path('', Home.as_view(), name='home')
12 | Including another URLconf
13 |     1. Import the include() function: from django.urls import include, path
14 |     2. Add a URL to urlpatterns:  path('blog', include('blog.urls'))
15 | """
16 | from django.urls import path, include, re_path
17 | 
18 | from polaris import settings
19 | 
20 | 
21 | urlpatterns = []
22 | if "sep-1" in settings.ACTIVE_SEPS:
23 |     urlpatterns.append(path(".well-known/", include("polaris.sep1.urls")))
24 | 
25 | if "sep-6" in settings.ACTIVE_SEPS:
26 |     urlpatterns.append(path("sep6/", include("polaris.sep6.urls")))
27 | 
28 | if "sep-10" in settings.ACTIVE_SEPS:
29 |     urlpatterns.append(re_path(r"^auth/?", include("polaris.sep10.urls")))
30 | 
31 | if "sep-12" in settings.ACTIVE_SEPS:
32 |     urlpatterns.append(path("kyc/", include("polaris.sep12.urls")))
33 | 
34 | if "sep-24" in settings.ACTIVE_SEPS:
35 |     urlpatterns.append(path("sep24/", include("polaris.sep24.urls")))
36 | 
37 | if "sep-31" in settings.ACTIVE_SEPS:
38 |     urlpatterns.append(path("sep31/", include("polaris.sep31.urls")))
39 | 
40 | if "sep-38" in settings.ACTIVE_SEPS:
41 |     urlpatterns.append(path("sep38/", include("polaris.sep38.urls")))
42 | 


--------------------------------------------------------------------------------
/pyproject.toml:
--------------------------------------------------------------------------------
  1 | [build-system]
  2 | requires = ["poetry-core>=1.0.0"]
  3 | build-backend = "poetry.core.masonry.api"
  4 | 
  5 | [tool.poetry]
  6 | name = "django-polaris"
  7 | version = "2.6.0"
  8 | description = "An extendable Django server for Stellar Ecosystem Proposals."
  9 | license = "Apache-2.0"
 10 | authors = ["Stellar Development Foundation <jake@stellar.org>"]
 11 | readme = "README.rst"
 12 | homepage = "https://github.com/stellar/django-polaris"
 13 | repository = "https://github.com/stellar/django-polaris"
 14 | documentation = "https://django-polaris.readthedocs.io/en/stable"
 15 | keywords = ["stellar", "anchor", "polaris", "sep", "server"]
 16 | classifiers = [
 17 |     "Environment :: Web Environment",
 18 |     "Framework :: Django",
 19 |     "Framework :: Django :: 4.2",
 20 |     "Intended Audience :: Developers",
 21 |     "License :: OSI Approved :: Apache Software License",
 22 |     "Operating System :: OS Independent",
 23 |     "Programming Language :: Python",
 24 |     "Programming Language :: Python :: 3",
 25 |     "Programming Language :: Python :: 3 :: Only",
 26 |     "Programming Language :: Python :: 3.10",
 27 |     "Programming Language :: Python :: 3.11",
 28 |     "Programming Language :: Python :: 3.12",
 29 |     "Programming Language :: Python :: 3.13",
 30 | ]
 31 | packages = [{ "include" = "polaris" }]
 32 | exclude = ["**/*.scss", "**/tests/*"]
 33 | 
 34 | [tool.poetry.urls]
 35 | "Release Notes" = "https://github.com/stellar/django-polaris/releases"
 36 | "Bug Tracker" = "https://github.com/stellar/django-polaris/issues"
 37 | 
 38 | [tool.poetry.dependencies]
 39 | python = "^3.10"
 40 | django = ">=4.2"
 41 | asgiref = ">=3.2"
 42 | django-model-utils = ">=4.1"
 43 | djangorestframework = ">=3.12"
 44 | whitenoise = ">=5.3"
 45 | stellar-sdk = { version = ">=10", extras=["aiohttp"] }
 46 | aiohttp = ">=3.7"
 47 | django-cors-headers = ">=3.7"
 48 | pyjwt = ">=2.1"
 49 | cryptography = ">=41.0"
 50 | sqlparse = ">=0.4.2"
 51 | django-environ = "*"
 52 | toml = "*"
 53 | pytz = "*"
 54 | readthedocs-sphinx-ext = { version = "^2.1", optional = true }
 55 | sphinx = { version = "^8.1", optional = true }
 56 | sphinx-rtd-theme = { version = "^3.0", optional = true }
 57 | sphinx-autodoc-typehints = { version = "*", optional = true }
 58 | gunicorn = { version = "*", optional = true }
 59 | psycopg2-binary = { version = ">=2.9", optional = true }
 60 | watchdog = { version = "*", optional = true }
 61 | 
 62 | [tool.poetry.group.dev.dependencies]
 63 | pylint = "*"
 64 | pylint-django = "*"
 65 | pytest = "*"
 66 | pytest-django = "*"
 67 | pytest-asyncio = "*"
 68 | pytest-cov = "*"
 69 | codecov = "*"
 70 | libsass = "*"
 71 | build = "*"
 72 | black = "*"
 73 | 
 74 | [tool.poetry.extras]
 75 | dev-server = ["gunicorn", "psycopg2-binary", "watchdog"]
 76 | docs = [
 77 |     "readthedocs-sphinx-ext",
 78 |     "sphinx",
 79 |     "sphinx-rtd-theme",
 80 |     "sphinx-autodoc-typehints",
 81 | ]
 82 | 
 83 | [tool.coverage.run]
 84 | source = ["polaris"]
 85 | omit = [
 86 |     "**/admin.py",
 87 |     "**/apps.py",
 88 |     "**/migrations/*",
 89 |     "**/settings.py",
 90 |     "**/tests/*",
 91 |     "**/urls.py",
 92 |     "**/wsgi.py",
 93 |     "**/collectstatic/*",
 94 |     "**/manage.py",
 95 |     "**/.venv/*",
 96 |     "**/.local/*",
 97 | ]
 98 | 
 99 | [tool.coverage.report]
100 | exclude_lines = ["pragma: no cover", "raise NotImplementedError", "def __str__"]
101 | 


--------------------------------------------------------------------------------
/pytest.ini:
--------------------------------------------------------------------------------
1 | [pytest]
2 | DJANGO_SETTINGS_MODULE = polaris.tests.settings
3 | python_files = test.py test_*.py *_test.py
4 | addopts = --rootdir polaris --ignore server
5 | asyncio_mode = auto
6 | asyncio_default_fixture_loop_scope = function
7 | 


--------------------------------------------------------------------------------
/readthedocs.yml:
--------------------------------------------------------------------------------
 1 | # readthedocs.yml
 2 | # Read the Docs configuration file
 3 | # See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
 4 | 
 5 | # Required
 6 | version: 2
 7 | 
 8 | # Build documentation in the docs/ directory with Sphinx
 9 | sphinx:
10 |   configuration: docs/conf.py
11 | 
12 | build:
13 |   os: ubuntu-lts-latest
14 |   tools:
15 |     python: "3.10"
16 | 
17 | python:
18 |   install:
19 |     - requirements: docs/requirements.txt
20 | 


--------------------------------------------------------------------------------
/server/README.rst:
--------------------------------------------------------------------------------
 1 | Example Server
 2 | --------------
 3 | 
 4 | .. _`testanchor.stellar.org`: https://testanchor.stellar.org/.well-known/stellar.toml
 5 | .. _`SRT (Stellar Reference Token)`: https://stellar.expert/explorer/testnet/asset/SRT-GCDNJUBQSX7AJWLJACMJ7I4BC3Z47BQUTMHEICZLE6MU4KQBRYG5JY6B-1
 6 | 
 7 | A reference implementation of a Polaris anchor. Deployed to `testanchor.stellar.org`_ for `SRT (Stellar Reference Token)`_ on testnet.
 8 | 
 9 | **This application is not production-ready and should only be used for reference**. It is meant to demonstrate basic usage of the various integrations and configurations Polaris provides.
10 | 


--------------------------------------------------------------------------------
/server/__init__.py:
--------------------------------------------------------------------------------
1 | default_app_config = "server.apps.AnchorConfig"
2 | 


--------------------------------------------------------------------------------
/server/admin.py:
--------------------------------------------------------------------------------
 1 | from django.contrib import admin
 2 | from .models import PolarisUser, PolarisStellarAccount, PolarisUserTransaction
 3 | 
 4 | 
 5 | class PolarisUserAdmin(admin.ModelAdmin):
 6 |     list_display = (
 7 |         "id",
 8 |         "first_name",
 9 |         "last_name",
10 |         "email",
11 |     )
12 | 
13 | 
14 | class PolarisStellarAccountAdmin(admin.ModelAdmin):
15 |     list_display = "user", "account", "confirmed"
16 | 
17 | 
18 | class PolarisUserTransactionAdmin(admin.ModelAdmin):
19 |     list_display = "transaction_id", "account", "user"
20 | 
21 | 
22 | admin.site.register(PolarisUser, PolarisUserAdmin)
23 | admin.site.register(PolarisStellarAccount, PolarisStellarAccountAdmin)
24 | admin.site.register(PolarisUserTransaction, PolarisUserTransactionAdmin)
25 | 


--------------------------------------------------------------------------------
/server/apps.py:
--------------------------------------------------------------------------------
 1 | from django.apps import AppConfig
 2 | 
 3 | 
 4 | class AnchorConfig(AppConfig):
 5 |     name = "server"
 6 | 
 7 |     def ready(self):
 8 |         from polaris.integrations import register_integrations
 9 |         from .integrations import (
10 |             MyDepositIntegration,
11 |             MyWithdrawalIntegration,
12 |             MyCustomerIntegration,
13 |             MySEP31ReceiverIntegration,
14 |             MyRailsIntegration,
15 |             MyQuoteIntegration,
16 |             fee_integration,
17 |             info_integration,
18 |         )
19 | 
20 |         register_integrations(
21 |             deposit=MyDepositIntegration(),
22 |             withdrawal=MyWithdrawalIntegration(),
23 |             fee=fee_integration,
24 |             sep6_info=info_integration,
25 |             customer=MyCustomerIntegration(),
26 |             sep31_receiver=MySEP31ReceiverIntegration(),
27 |             rails=MyRailsIntegration(),
28 |             quote=MyQuoteIntegration(),
29 |         )
30 | 


--------------------------------------------------------------------------------
/server/collectstatic/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/server/collectstatic/__init__.py


--------------------------------------------------------------------------------
/server/example-nginx.conf:
--------------------------------------------------------------------------------
 1 | # Example configuration for Django Polaris (https://github.com/stellar/django-polaris)
 2 | # using Nginx as reverse proxy with HTTPS enabled.
 3 | 
 4 | # NOTE: This configuration is not used in the deployment of this example
 5 | # application, it's here purely for reference.
 6 | 
 7 | # This configuration has been tested with:
 8 | # 1) Ubuntu 20.04.1 LTS
 9 | # 2) Polaris running on localhost:8000
10 | # 3) Let's Encrypt Certbot was used for auto generating the SSL config lines,
11 | #    so there might be differences between these lines and lines generated
12 | #    by Certbot in other systems (Debian, RedHat, etc).
13 | 
14 | server {
15 |     server_name stellar-anchor.mydomain.com;
16 | 
17 |     location / {
18 |         proxy_pass http://localhost:8000;
19 |         proxy_set_header Host $host;
20 |         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
21 |         proxy_set_header X-Forwarded-Proto $scheme;
22 | 
23 |         # Situational:
24 |         # proxy_redirect http://localhost:8000 https://stellar-anchor.mydomain.com;
25 |     }
26 | 
27 |     listen [::]:443 ssl ipv6only=on; # managed by Let's Encrypt Certbot
28 |     listen 443 ssl; # managed by Let's Encrypt Certbot
29 |     ssl_certificate ...; # managed by Let's Encrypt Certbot
30 |     ssl_certificate_key ...; # managed by Let's Encrypt Certbot
31 |     include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Let's Encrypt Certbot
32 |     ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Let's Encrypt Certbot
33 | 
34 | }
35 | 
36 | server {
37 |     if ($host = stellar-anchor.mydomain.com) {
38 |         return 301 https://$host$request_uri;
39 |     } # managed by Let's Encrypt Certbot
40 | 
41 |     listen 80 default_server;
42 |     listen [::]:80 default_server;
43 | 
44 |     server_name stellar-anchor.mydomain.com;
45 |     return 404; # managed by Let's Encrypt Certbot
46 | }
47 | 
48 | 
49 | 


--------------------------------------------------------------------------------
/server/forms.py:
--------------------------------------------------------------------------------
  1 | from django import forms
  2 | from django.utils.translation import gettext_lazy as _
  3 | 
  4 | from polaris.integrations.forms import TransactionForm
  5 | 
  6 | 
  7 | class KYCForm(forms.Form):
  8 |     first_name = forms.CharField(
  9 |         max_length=254,
 10 |         widget=forms.TextInput(attrs={"class": "input", "test-value": "Albert"}),
 11 |         label=_("First Name"),
 12 |     )
 13 |     last_name = forms.CharField(
 14 |         max_length=254,
 15 |         widget=forms.TextInput(attrs={"class": "input", "test-value": "Einstein"}),
 16 |         label=_("Last Name"),
 17 |     )
 18 |     email = forms.EmailField(
 19 |         widget=forms.TextInput(
 20 |             attrs={"class": "input", "test-value": "clerk@patentoffice.gov"}
 21 |         ),
 22 |         label=_("Email"),
 23 |     )
 24 | 
 25 | 
 26 | class WithdrawForm(TransactionForm):
 27 |     """This form accepts the amount to withdraw from the user."""
 28 | 
 29 |     type = forms.ChoiceField(
 30 |         choices=[(None, "--"), ("bank_account", "Bank Account")],
 31 |         label="Transaction Type",
 32 |     )
 33 |     bank_account = forms.CharField(
 34 |         min_length=0,
 35 |         help_text=_("Enter the bank account number for withdrawal."),
 36 |         widget=forms.widgets.TextInput(
 37 |             attrs={"class": "input", "test-value": "FakeAccount"}
 38 |         ),
 39 |         label=_("Bank Account"),
 40 |     )
 41 |     # TODO: Replace the bank with a ChoiceField.
 42 |     bank = forms.CharField(
 43 |         min_length=0,
 44 |         help_text=_("Enter the bank to withdraw from."),
 45 |         widget=forms.widgets.TextInput(
 46 |             attrs={"class": "input", "test-value": "FakeBank"}
 47 |         ),
 48 |         label=_("Bank"),
 49 |     )
 50 | 
 51 | 
 52 | class AllFieldsForm(forms.Form):
 53 |     text = forms.CharField(required=False, label=_("Text"))
 54 |     checkbox = forms.BooleanField(required=False, label=_("Checkbox"))
 55 |     select = forms.ChoiceField(
 56 |         choices=[(1, _("Option 1")), (2, _("Option 2")), (3, _("Option 3"))],
 57 |         required=False,
 58 |         label=_("Select"),
 59 |     )
 60 |     multiple_choice = forms.MultipleChoiceField(
 61 |         choices=[(1, _("Option 1")), (2, _("Option 2")), (3, _("Option 3"))],
 62 |         required=False,
 63 |         label=_("Multiple Choice"),
 64 |     )
 65 |     datetime = forms.DateTimeField(required=False, label=_("Datetime"))
 66 |     date = forms.DateField(required=False, label=_("Date"))
 67 |     time = forms.TimeField(required=False, label=_("Time"))
 68 |     file = forms.FileField(required=False, label=_("File"))
 69 |     textarea = forms.CharField(
 70 |         widget=forms.Textarea, required=False, label=_("Textarea")
 71 |     )
 72 |     password = forms.CharField(
 73 |         widget=forms.PasswordInput, required=False, label=_("Password")
 74 |     )
 75 | 
 76 | 
 77 | class SelectAssetForm(forms.Form):
 78 |     asset = forms.ChoiceField(
 79 |         choices=[
 80 |             (
 81 |                 "stellar:SRT:GCDNJUBQSX7AJWLJACMJ7I4BC3Z47BQUTMHEICZLE6MU4KQBRYG5JY6B",
 82 |                 "Stellar Reference Token (SRT)",
 83 |             ),
 84 |             (
 85 |                 "stellar:USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
 86 |                 "Circle USDC Token (USDC)",
 87 |             ),
 88 |             ("iso4217:USD", "United States Dollar (USD)"),
 89 |         ],
 90 |         # this is to remove the '*' character on the template
 91 |         # one of the choices will always be selected anyway
 92 |         required=False,
 93 |     )
 94 | 
 95 | 
 96 | class OffChainAssetTransactionForm(forms.Form):
 97 |     amount = forms.DecimalField(
 98 |         widget=forms.TextInput(
 99 |             attrs={
100 |                 "class": "usd-offchain-asset-transaction-form",
101 |                 "symbol": "USD",
102 |                 "placeholder": "0",
103 |             },
104 |         ),
105 |         label=_("Amount"),
106 |         localize=True,
107 |         decimal_places=2,
108 |     )
109 | 
110 | 
111 | class ConfirmationForm(forms.Form):
112 |     pass
113 | 


--------------------------------------------------------------------------------
/server/integrations/__init__.py:
--------------------------------------------------------------------------------
 1 | from .deposit import MyDepositIntegration
 2 | from .withdraw import MyWithdrawalIntegration
 3 | from .sep31 import MySEP31ReceiverIntegration
 4 | from .customers import MyCustomerIntegration
 5 | from .info import info_integration
 6 | from .fee import fee_integration
 7 | from .quotes import MyQuoteIntegration
 8 | from .rails import MyRailsIntegration
 9 | 
10 | __all__ = [
11 |     "MyDepositIntegration",
12 |     "MyWithdrawalIntegration",
13 |     "MyRailsIntegration",
14 |     "MyCustomerIntegration",
15 |     "MySEP31ReceiverIntegration",
16 |     "MyQuoteIntegration",
17 |     "info_integration",
18 |     "fee_integration",
19 | ]
20 | 


--------------------------------------------------------------------------------
/server/integrations/fee.py:
--------------------------------------------------------------------------------
 1 | from decimal import Decimal
 2 | from typing import Dict
 3 | 
 4 | from polaris.integrations import calculate_fee
 5 | 
 6 | 
 7 | def fee_integration(fee_params: Dict, *args, **kwargs) -> Decimal:
 8 |     """
 9 |     This function replaces the default registered_fee_func for demonstration
10 |     purposes.
11 | 
12 |     However, since we don't have any custom logic to implement, it simply
13 |     calls the default that has been replaced.
14 |     """
15 |     return calculate_fee(fee_params)
16 | 


--------------------------------------------------------------------------------
/server/integrations/info.py:
--------------------------------------------------------------------------------
 1 | from rest_framework.request import Request
 2 | from django.utils.translation import gettext as _
 3 | 
 4 | from polaris.models import Asset
 5 | import settings
 6 | 
 7 | 
 8 | def info_integration(request: Request, asset: Asset, lang: str, *args, **kwargs):
 9 |     # Not using `asset` since this reference server only supports SRT
10 |     languages = [l[0] for l in settings.LANGUAGES]
11 |     if lang and lang not in languages:
12 |         raise ValueError()
13 |     return {
14 |         "fields": {
15 |             "type": {
16 |                 "description": _("'bank_account' is the only value supported'"),
17 |                 "choices": ["bank_account"],
18 |             },
19 |         },
20 |         "types": {
21 |             "bank_account": {
22 |                 "fields": {
23 |                     "dest": {"description": _("bank account number")},
24 |                     "dest_extra": {"description": _("bank routing number")},
25 |                 }
26 |             }
27 |         },
28 |     }
29 | 


--------------------------------------------------------------------------------
/server/integrations/mock_banking_rails.py:
--------------------------------------------------------------------------------
 1 | """
 2 | This module contains a fake banking rails interface to use for the purposes of
 3 | this example anchor server. In reality, the anchor should use whatever interface
 4 | connects them with their real bank account.
 5 | """
 6 | from uuid import uuid4
 7 | from decimal import Decimal
 8 | from polaris.models import Transaction
 9 | 
10 | 
11 | class BankAccount:
12 |     def __init__(self, account_id: str):
13 |         self.id = account_id
14 | 
15 | 
16 | class BankTransaction:
17 |     def __init__(self, to_account: BankAccount, amount: Decimal, memo: str):
18 |         self.id = str(uuid4())
19 |         self.to_account = to_account
20 |         self.from_account = BankAccount(str(uuid4()))
21 |         self.amount = amount
22 |         self.status = "complete"
23 |         self.memo = memo
24 | 
25 | 
26 | class BankAPIClient:
27 |     def __init__(self, account_id):
28 |         self.account = BankAccount(account_id)
29 | 
30 |     def get_deposit(self, deposit):
31 |         """
32 |         A fake banking rails function for retrieving a RailsTransaction object.
33 | 
34 |         When a deposit is initiated by making a POST /deposit/interactive call,
35 |         we (the anchor) display instructions with a fake `memo` string that the
36 |         user would (in theory) use when making the deposit to the anchor's
37 |         account. However when passed the `deposit` Transaction object, we simply
38 |         return a fake BankTransaction object for the purposes of providing an
39 |         example.
40 | 
41 |         Then, when polling the bank for new deposits into the anchor's account,
42 |         we identify a Transaction database object using the memo originally
43 |         displayed to the user.
44 | 
45 |         This is intended to be an example for how a real anchor would poll the
46 |         anchors bank and identify a deposit from a particular user.
47 |         """
48 |         return BankTransaction(self.account, deposit.amount_in, deposit.memo)
49 | 
50 |     def send_funds(self, to_account: str, amount: Decimal):
51 |         """
52 |         A fake function to symbolize sending money from an anchor's bank
53 |         account to the user's bank account.
54 |         """
55 |         return {"success": True}
56 | 


--------------------------------------------------------------------------------
/server/integrations/mock_exchange.py:
--------------------------------------------------------------------------------
 1 | import math
 2 | import random
 3 | import time
 4 | 
 5 | # Rotates the random number at the specified interval
 6 | from decimal import Decimal
 7 | 
 8 | rotation_interval = 30
 9 | 
10 | 
11 | def _get_rotating_random_number() -> float:
12 |     """
13 |     Generate a random number every `rotation_interval` seconds.
14 |     """
15 |     random.seed(math.floor(time.time() / rotation_interval))
16 |     return 0.5 + 0.01 * random.randint(0, 100)
17 | 
18 | 
19 | def get_mock_indicative_exchange_price() -> Decimal:
20 |     return Decimal(_get_rotating_random_number())
21 | 
22 | 
23 | def get_mock_firm_exchange_price() -> Decimal:
24 |     return Decimal(_get_rotating_random_number() + 0.1)
25 | 


--------------------------------------------------------------------------------
/server/integrations/quotes.py:
--------------------------------------------------------------------------------
  1 | import random
  2 | from datetime import datetime, timedelta, timezone
  3 | from decimal import Decimal
  4 | from typing import Union, List, Optional
  5 | 
  6 | from requests import RequestException
  7 | from rest_framework.request import Request
  8 | 
  9 | from polaris import settings
 10 | from polaris.integrations import QuoteIntegration
 11 | from polaris.models import Asset, OffChainAsset, DeliveryMethod, Quote
 12 | from polaris.sep10.token import SEP10Token
 13 | 
 14 | from .mock_exchange import (
 15 |     get_mock_indicative_exchange_price,
 16 |     get_mock_firm_exchange_price,
 17 | )
 18 | 
 19 | 
 20 | class MyQuoteIntegration(QuoteIntegration):
 21 |     def get_prices(
 22 |         self,
 23 |         token: SEP10Token,
 24 |         request: Request,
 25 |         sell_asset: Union[Asset, OffChainAsset],
 26 |         sell_amount: Decimal,
 27 |         buy_assets: List[Union[Asset, OffChainAsset]],
 28 |         sell_delivery_method: Optional[DeliveryMethod] = None,
 29 |         buy_delivery_method: Optional[DeliveryMethod] = None,
 30 |         country_code: Optional[str] = None,
 31 |         *args,
 32 |         **kwargs,
 33 |     ) -> List[Decimal]:
 34 |         prices = []
 35 |         for _ in buy_assets:
 36 |             try:
 37 |                 prices.append(
 38 |                     Decimal(
 39 |                         round(
 40 |                             get_mock_indicative_exchange_price(),
 41 |                             sell_asset.significant_decimals,
 42 |                         )
 43 |                     )
 44 |                 )
 45 |             except RequestException:
 46 |                 raise RuntimeError("unable to fetch prices")
 47 |         return prices
 48 | 
 49 |     def get_price(
 50 |         self,
 51 |         token: SEP10Token,
 52 |         request: Request,
 53 |         sell_asset: Union[Asset, OffChainAsset],
 54 |         buy_asset: Union[Asset, OffChainAsset],
 55 |         buy_amount: Optional[Decimal] = None,
 56 |         sell_amount: Optional[Decimal] = None,
 57 |         sell_delivery_method: Optional[DeliveryMethod] = None,
 58 |         buy_delivery_method: Optional[DeliveryMethod] = None,
 59 |         country_code: Optional[str] = None,
 60 |         *args,
 61 |         **kwargs,
 62 |     ) -> Decimal:
 63 |         try:
 64 |             return Decimal(
 65 |                 round(
 66 |                     get_mock_indicative_exchange_price(),
 67 |                     sell_asset.significant_decimals,
 68 |                 )
 69 |             )
 70 |         except RequestException:
 71 |             raise RuntimeError("unable to fetch price")
 72 | 
 73 |     @staticmethod
 74 |     def approve_expiration(_expire_after) -> bool:
 75 |         return True
 76 | 
 77 |     def post_quote(
 78 |         self,
 79 |         token: SEP10Token,
 80 |         request: Request,
 81 |         quote: Quote,
 82 |         *args,
 83 |         **kwargs,
 84 |     ) -> Quote:
 85 |         if quote.requested_expire_after and not self.approve_expiration(
 86 |             quote.requested_expire_after
 87 |         ):
 88 |             raise ValueError(
 89 |                 f"expiration ({quote.requested_expire_after.strftime(settings.DATETIME_FORMAT)}) cannot be provided.",
 90 |             )
 91 |         if quote.sell_asset.startswith("stellar"):
 92 |             _, code, issuer = quote.sell_asset.split(":")
 93 |             asset = Asset.objects.get(code=code, issuer=issuer)
 94 |             significant_decimals = asset.significant_decimals
 95 |         else:
 96 |             scheme, identifier = quote.sell_asset.split(":")
 97 |             offchain_asset = OffChainAsset.objects.get(
 98 |                 scheme=scheme, identifier=identifier
 99 |             )
100 |             significant_decimals = offchain_asset.significant_decimals
101 |         try:
102 |             quote.price = round(get_mock_firm_exchange_price(), significant_decimals)
103 |         except RequestException:
104 |             raise RuntimeError("unable to fetch price for quote")
105 |         quote.expires_at = datetime.now(timezone.utc) + timedelta(
106 |             minutes=random.randrange(5, 60)
107 |         )
108 |         return quote
109 | 


--------------------------------------------------------------------------------
/server/locale/id/LC_MESSAGES/django.mo:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/server/locale/id/LC_MESSAGES/django.mo


--------------------------------------------------------------------------------
/server/locale/pt/LC_MESSAGES/django.mo:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/server/locale/pt/LC_MESSAGES/django.mo


--------------------------------------------------------------------------------
/server/management/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/server/management/__init__.py


--------------------------------------------------------------------------------
/server/management/commands/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/server/management/commands/__init__.py


--------------------------------------------------------------------------------
/server/management/commands/sign_multisig_transactions.py:
--------------------------------------------------------------------------------
 1 | import time
 2 | import sys
 3 | import signal
 4 | 
 5 | from polaris import settings
 6 | from polaris.utils import getLogger
 7 | from polaris.models import Transaction
 8 | 
 9 | from django.core.management.base import BaseCommand, CommandError
10 | from stellar_sdk import TransactionEnvelope, Keypair
11 | from django.conf import settings as django_settings
12 | 
13 | logger = getLogger(__name__)
14 | TERMINATE = False
15 | DEFAULT_INTERVAL = 10
16 | 
17 | 
18 | class Command(BaseCommand):
19 |     def __init__(self, *args, **kwargs):
20 |         super().__init__(*args, **kwargs)
21 |         signal.signal(signal.SIGINT, self.exit_gracefully)
22 |         signal.signal(signal.SIGTERM, self.exit_gracefully)
23 | 
24 |     @staticmethod
25 |     def exit_gracefully(sig, frame):
26 |         module = sys.modules[__name__]
27 |         module.TERMINATE = True
28 | 
29 |     @staticmethod
30 |     def sleep(seconds):
31 |         module = sys.modules[__name__]
32 |         for _ in range(seconds):
33 |             if module.TERMINATE:
34 |                 break
35 |             time.sleep(1)
36 | 
37 |     def add_arguments(self, parser):
38 |         parser.add_argument(
39 |             "--loop",
40 |             action="store_true",
41 |             help="Continually restart command after a specified number of seconds.",
42 |         )
43 |         parser.add_argument(
44 |             "--interval",
45 |             "-i",
46 |             type=int,
47 |             help="The number of seconds to wait before restarting command. "
48 |             "Defaults to {}.".format(DEFAULT_INTERVAL),
49 |         )
50 | 
51 |     def handle(self, *args, **options):
52 |         module = sys.modules[__name__]
53 |         if options.get("loop"):
54 |             while True:
55 |                 if module.TERMINATE:
56 |                     break
57 |                 self.sign_multisig_transactions()
58 |                 self.sleep(options.get("interval") or DEFAULT_INTERVAL)
59 |         else:
60 |             self.sign_multisig_transactions()
61 | 
62 |     def sign_multisig_transactions(self):
63 |         transactions = Transaction.objects.filter(
64 |             pending_signatures=True,
65 |             envelope_xdr__isnull=False,
66 |             status=Transaction.STATUS.pending_anchor,
67 |         ).all()
68 |         for t in transactions:
69 |             envelope = TransactionEnvelope.from_xdr(
70 |                 t.envelope_xdr, settings.STELLAR_NETWORK_PASSPHRASE
71 |             )
72 |             if not django_settings.MULT_ASSET_ADDITIONAL_SIGNING_SEED:
73 |                 raise CommandError(
74 |                     "MULT's 2nd signer is not specified in the environment"
75 |                 )
76 |             envelope.sign(django_settings.MULT_ASSET_ADDITIONAL_SIGNING_SEED)
77 |             t.envelope_xdr = envelope.to_xdr()
78 |             t.pending_signatures = False
79 |             t.save()
80 |             logger.info(f"Transaction {t.id} signatures have been collected")
81 | 


--------------------------------------------------------------------------------
/server/migrations/0001_initial.py:
--------------------------------------------------------------------------------
 1 | # Generated by Django 2.2.8 on 2020-01-07 23:36
 2 | 
 3 | from django.db import migrations, models
 4 | from django.core.validators import MinLengthValidator
 5 | import django.db.models.deletion
 6 | 
 7 | 
 8 | class Migration(migrations.Migration):
 9 |     initial = True
10 | 
11 |     dependencies = [
12 |         ("polaris", "0001_initial"),
13 |     ]
14 | 
15 |     operations = [
16 |         migrations.CreateModel(
17 |             name="PolarisUser",
18 |             fields=[
19 |                 (
20 |                     "id",
21 |                     models.AutoField(
22 |                         auto_created=True,
23 |                         primary_key=True,
24 |                         serialize=False,
25 |                         verbose_name="ID",
26 |                     ),
27 |                 ),
28 |                 ("first_name", models.CharField(max_length=254)),
29 |                 ("last_name", models.CharField(max_length=254)),
30 |                 ("email", models.EmailField(max_length=254, unique=True)),
31 |             ],
32 |         ),
33 |         migrations.CreateModel(
34 |             name="PolarisStellarAccount",
35 |             fields=[
36 |                 (
37 |                     "id",
38 |                     models.AutoField(
39 |                         auto_created=True,
40 |                         primary_key=True,
41 |                         serialize=False,
42 |                         verbose_name="ID",
43 |                     ),
44 |                 ),
45 |                 (
46 |                     "account",
47 |                     models.CharField(
48 |                         max_length=56, unique=True, validators=[MinLengthValidator(56)]
49 |                     ),
50 |                 ),
51 |                 (
52 |                     "user",
53 |                     models.ForeignKey(
54 |                         on_delete=django.db.models.deletion.CASCADE,
55 |                         to="server.PolarisUser",
56 |                     ),
57 |                 ),
58 |             ],
59 |         ),
60 |         migrations.CreateModel(
61 |             name="PolarisUserTransaction",
62 |             fields=[
63 |                 (
64 |                     "id",
65 |                     models.AutoField(
66 |                         auto_created=True,
67 |                         primary_key=True,
68 |                         serialize=False,
69 |                         verbose_name="ID",
70 |                     ),
71 |                 ),
72 |                 (
73 |                     "account",
74 |                     models.ForeignKey(
75 |                         on_delete=django.db.models.deletion.CASCADE,
76 |                         to="server.PolarisStellarAccount",
77 |                     ),
78 |                 ),
79 |                 (
80 |                     "transaction",
81 |                     models.OneToOneField(
82 |                         on_delete=django.db.models.deletion.CASCADE,
83 |                         to="polaris.Transaction",
84 |                     ),
85 |                 ),
86 |             ],
87 |         ),
88 |     ]
89 | 


--------------------------------------------------------------------------------
/server/migrations/0002_auto_20200207_0002.py:
--------------------------------------------------------------------------------
 1 | # Generated by Django 2.2.9 on 2020-02-07 00:02
 2 | 
 3 | from django.db import migrations, models
 4 | from .. import models as polaris_models
 5 | 
 6 | 
 7 | class Migration(migrations.Migration):
 8 |     dependencies = [
 9 |         ("server", "0001_initial"),
10 |     ]
11 | 
12 |     operations = [
13 |         migrations.AddField(
14 |             model_name="polarisuser",
15 |             name="confirmation_token",
16 |             field=models.CharField(default=polaris_models.get_new_token, max_length=36),
17 |         ),
18 |         migrations.AddField(
19 |             model_name="polarisuser",
20 |             name="confirmed",
21 |             field=models.BooleanField(default=False),
22 |         ),
23 |     ]
24 | 


--------------------------------------------------------------------------------
/server/migrations/0003_auto_20200222_0003.py:
--------------------------------------------------------------------------------
 1 | # Generated by Django 2.2.10 on 2020-02-22 00:03
 2 | 
 3 | from django.db import migrations, models
 4 | import server.models
 5 | 
 6 | 
 7 | class Migration(migrations.Migration):
 8 |     dependencies = [
 9 |         ("server", "0002_auto_20200207_0002"),
10 |     ]
11 | 
12 |     operations = [
13 |         migrations.RemoveField(
14 |             model_name="polarisuser",
15 |             name="confirmation_token",
16 |         ),
17 |         migrations.RemoveField(
18 |             model_name="polarisuser",
19 |             name="confirmed",
20 |         ),
21 |         migrations.AddField(
22 |             model_name="polarisstellaraccount",
23 |             name="confirmation_token",
24 |             field=models.CharField(default=server.models.get_new_token, max_length=36),
25 |         ),
26 |         migrations.AddField(
27 |             model_name="polarisstellaraccount",
28 |             name="confirmed",
29 |             field=models.BooleanField(default=False),
30 |         ),
31 |     ]
32 | 


--------------------------------------------------------------------------------
/server/migrations/0004_auto_20200427_2302.py:
--------------------------------------------------------------------------------
 1 | # Generated by Django 2.2.10 on 2020-04-27 23:02
 2 | 
 3 | from django.db import migrations, models
 4 | 
 5 | 
 6 | class Migration(migrations.Migration):
 7 |     dependencies = [
 8 |         ("server", "0003_auto_20200222_0003"),
 9 |     ]
10 | 
11 |     operations = [
12 |         migrations.AddField(
13 |             model_name="polarisuser",
14 |             name="bank_account_number",
15 |             field=models.CharField(max_length=254, null=True),
16 |         ),
17 |         migrations.AddField(
18 |             model_name="polarisuser",
19 |             name="bank_number",
20 |             field=models.CharField(max_length=254, null=True),
21 |         ),
22 |     ]
23 | 


--------------------------------------------------------------------------------
/server/migrations/0005_auto_20200702_1908.py:
--------------------------------------------------------------------------------
 1 | # Generated by Django 2.2.13 on 2020-07-02 19:08
 2 | 
 3 | import django.core.validators
 4 | from django.db import migrations, models
 5 | 
 6 | 
 7 | class Migration(migrations.Migration):
 8 |     dependencies = [
 9 |         ("server", "0004_auto_20200427_2302"),
10 |     ]
11 | 
12 |     operations = [
13 |         migrations.AddField(
14 |             model_name="polarisstellaraccount",
15 |             name="memo",
16 |             field=models.TextField(blank=True, null=True),
17 |         ),
18 |         migrations.AddField(
19 |             model_name="polarisstellaraccount",
20 |             name="memo_type",
21 |             field=models.TextField(blank=True, null=True),
22 |         ),
23 |         migrations.AlterField(
24 |             model_name="polarisstellaraccount",
25 |             name="account",
26 |             field=models.CharField(
27 |                 max_length=56,
28 |                 validators=[django.core.validators.MinLengthValidator(56)],
29 |             ),
30 |         ),
31 |         migrations.AlterUniqueTogether(
32 |             name="polarisstellaraccount",
33 |             unique_together={("memo", "account")},
34 |         ),
35 |     ]
36 | 


--------------------------------------------------------------------------------
/server/migrations/0006_auto_20200615_2046.py:
--------------------------------------------------------------------------------
 1 | # Generated by Django 2.2.12 on 2020-06-15 20:46
 2 | 
 3 | from django.db import migrations, models
 4 | import django.db.models.deletion
 5 | 
 6 | 
 7 | class Migration(migrations.Migration):
 8 |     """
 9 |     SEP31 allows anchors to deposit assets directly to a user's off-chain account.
10 |     This violates the assumption that every PolarisUserTransaction will have a stellar_account.
11 | 
12 |     Therefore, we add a user FK to PolarisUserTransaction and make its account FK column nullable.
13 |     Additionally, PolarisUserTransaction.transaction_id is changed to TextField instead of an FK,
14 |     since at time of creation the Transaction object does not exist.
15 |     """
16 | 
17 |     dependencies = [
18 |         ("server", "0005_auto_20200702_1908"),
19 |     ]
20 | 
21 |     operations = [
22 |         migrations.RenameField(
23 |             model_name="polarisusertransaction",
24 |             old_name="transaction",
25 |             new_name="temp_transaction",
26 |         ),
27 |         migrations.AddField(
28 |             model_name="polarisusertransaction",
29 |             name="transaction_id",
30 |             field=models.TextField(db_index=True, default="id"),
31 |             preserve_default=False,
32 |         ),
33 |         migrations.RunSQL(
34 |             "UPDATE server_polarisusertransaction SET transaction_id = temp_transaction_id"
35 |         ),
36 |         migrations.RemoveField(
37 |             model_name="polarisusertransaction",
38 |             name="temp_transaction",
39 |         ),
40 |         migrations.AddField(
41 |             model_name="polarisusertransaction",
42 |             name="user",
43 |             field=models.ForeignKey(
44 |                 null=True,
45 |                 on_delete=django.db.models.deletion.CASCADE,
46 |                 to="server.PolarisUser",
47 |             ),
48 |         ),
49 |         migrations.AlterField(
50 |             model_name="polarisusertransaction",
51 |             name="account",
52 |             field=models.ForeignKey(
53 |                 null=True,
54 |                 on_delete=django.db.models.deletion.CASCADE,
55 |                 to="server.PolarisStellarAccount",
56 |             ),
57 |         ),
58 |     ]
59 | 


--------------------------------------------------------------------------------
/server/migrations/0007_auto_20210921_2005.py:
--------------------------------------------------------------------------------
 1 | # Generated by Django 3.2.7 on 2021-09-21 20:05
 2 | 
 3 | from django.db import migrations, models
 4 | 
 5 | 
 6 | class Migration(migrations.Migration):
 7 |     dependencies = [
 8 |         ("server", "0006_auto_20200615_2046"),
 9 |     ]
10 | 
11 |     operations = [
12 |         migrations.AddField(
13 |             model_name="polarisstellaraccount",
14 |             name="muxed_account",
15 |             field=models.TextField(blank=True, null=True),
16 |         ),
17 |         migrations.AlterUniqueTogether(
18 |             name="polarisstellaraccount",
19 |             unique_together={("memo", "account", "muxed_account")},
20 |         ),
21 |     ]
22 | 


--------------------------------------------------------------------------------
/server/migrations/0008_offchainassetextra.py:
--------------------------------------------------------------------------------
 1 | # Generated by Django 3.2.8 on 2021-10-21 01:09
 2 | 
 3 | from django.db import migrations, models
 4 | import django.db.models.deletion
 5 | 
 6 | 
 7 | class Migration(migrations.Migration):
 8 |     dependencies = [
 9 |         ("polaris", "0013_auto_20211011_1956"),
10 |         ("server", "0007_auto_20210921_2005"),
11 |     ]
12 | 
13 |     operations = [
14 |         migrations.CreateModel(
15 |             name="OffChainAssetExtra",
16 |             fields=[
17 |                 (
18 |                     "offchain_asset",
19 |                     models.OneToOneField(
20 |                         on_delete=django.db.models.deletion.CASCADE,
21 |                         primary_key=True,
22 |                         serialize=False,
23 |                         to="polaris.offchainasset",
24 |                     ),
25 |                 ),
26 |                 (
27 |                     "fee_fixed",
28 |                     models.DecimalField(decimal_places=7, default=0, max_digits=30),
29 |                 ),
30 |                 ("fee_percent", models.PositiveIntegerField(default=0)),
31 |             ],
32 |         ),
33 |     ]
34 | 


--------------------------------------------------------------------------------
/server/migrations/0009_auto_20211028_2139.py:
--------------------------------------------------------------------------------
 1 | # Generated by Django 3.2.8 on 2021-10-28 21:39
 2 | 
 3 | from django.db import migrations, models
 4 | 
 5 | 
 6 | class Migration(migrations.Migration):
 7 |     dependencies = [
 8 |         ("server", "0008_offchainassetextra"),
 9 |     ]
10 | 
11 |     operations = [
12 |         migrations.AddField(
13 |             model_name="polarisusertransaction",
14 |             name="confirmed",
15 |             field=models.BooleanField(default=False),
16 |         ),
17 |         migrations.AddField(
18 |             model_name="polarisusertransaction",
19 |             name="requires_confirmation",
20 |             field=models.BooleanField(default=False),
21 |         ),
22 |     ]
23 | 


--------------------------------------------------------------------------------
/server/migrations/0010_auto_20230316_1120.py:
--------------------------------------------------------------------------------
 1 | # Generated by Django 3.2.18 on 2023-03-16 18:20
 2 | 
 3 | from django.db import migrations, models
 4 | 
 5 | 
 6 | class Migration(migrations.Migration):
 7 |     dependencies = [
 8 |         ("server", "0009_auto_20211028_2139"),
 9 |     ]
10 | 
11 |     operations = [
12 |         migrations.AddField(
13 |             model_name="polarisuser",
14 |             name="photo_id_back_provided",
15 |             field=models.BooleanField(default=False),
16 |         ),
17 |         migrations.AddField(
18 |             model_name="polarisuser",
19 |             name="photo_id_front_provided",
20 |             field=models.BooleanField(default=False),
21 |         ),
22 |     ]
23 | 


--------------------------------------------------------------------------------
/server/migrations/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/stellar/django-polaris/3e4e803c688941a6c6ff333c8e0b28c82394b457/server/migrations/__init__.py


--------------------------------------------------------------------------------
/server/models.py:
--------------------------------------------------------------------------------
 1 | from uuid import uuid4
 2 | 
 3 | from django.core.validators import MinLengthValidator
 4 | from django.db import models
 5 | 
 6 | from polaris.models import Transaction, OffChainAsset
 7 | 
 8 | 
 9 | def get_new_token():
10 |     return str(uuid4())
11 | 
12 | 
13 | class PolarisUser(models.Model):
14 |     first_name = models.CharField(max_length=254)
15 |     last_name = models.CharField(max_length=254)
16 |     email = models.EmailField(unique=True)
17 |     bank_account_number = models.CharField(max_length=254, null=True)
18 |     bank_number = models.CharField(max_length=254, null=True)
19 |     # we're not going to store images on our reference server
20 |     photo_id_front_provided = models.BooleanField(default=False)
21 |     photo_id_back_provided = models.BooleanField(default=False)
22 | 
23 |     objects = models.Manager()
24 | 
25 |     @property
26 |     def name(self):
27 |         return " ".join([str(self.first_name), str(self.last_name)])
28 | 
29 |     def __str__(self):
30 |         return f"{self.name} ({self.id})"
31 | 
32 | 
33 | class PolarisStellarAccount(models.Model):
34 |     user = models.ForeignKey(PolarisUser, on_delete=models.CASCADE)
35 |     memo = models.TextField(null=True, blank=True)
36 |     memo_type = models.TextField(null=True, blank=True)
37 |     account = models.CharField(max_length=56, validators=[MinLengthValidator(56)])
38 |     muxed_account = models.TextField(null=True, blank=True)
39 |     confirmed = models.BooleanField(default=False)
40 |     confirmation_token = models.CharField(max_length=36, default=get_new_token)
41 | 
42 |     objects = models.Manager()
43 | 
44 |     class Meta:
45 |         unique_together = ["memo", "account", "muxed_account"]
46 | 
47 |     def __str__(self):
48 |         return f"{str(self.user)}: {str(self.muxed_account or self.account)} (memo: {str(self.memo)})"
49 | 
50 | 
51 | class PolarisUserTransaction(models.Model):
52 |     """
53 |     Since we cannot add a PolarisStellarAccount foreign key to :class:`Transaction`,
54 |     this table serves to join the two entities.
55 |     """
56 | 
57 |     transaction_id = models.TextField(db_index=True)
58 |     user = models.ForeignKey(PolarisUser, on_delete=models.CASCADE, null=True)
59 |     account = models.ForeignKey(
60 |         PolarisStellarAccount, on_delete=models.CASCADE, null=True
61 |     )
62 |     requires_confirmation = models.BooleanField(default=False)
63 |     confirmed = models.BooleanField(default=False)
64 | 
65 |     @property
66 |     def transaction(self):
67 |         return Transaction.objects.filter(id=self.transaction_id).first()
68 | 
69 |     objects = models.Manager()
70 | 
71 |     def __str__(self):
72 |         return f"{str(self.account)}: {str(self.transaction)}"
73 | 
74 | 
75 | class OffChainAssetExtra(models.Model):
76 |     """
77 |     Extra information on off-chain assets that Polaris' model doesn't store
78 |     """
79 | 
80 |     offchain_asset = models.OneToOneField(
81 |         OffChainAsset, primary_key=True, on_delete=models.CASCADE
82 |     )
83 |     fee_fixed = models.DecimalField(default=0, max_digits=30, decimal_places=7)
84 |     fee_percent = models.PositiveIntegerField(default=0)
85 | 
86 |     objects = models.Manager()
87 | 
88 |     def __str__(self):
89 |         return f"OffChainAsset: {self.offchain_asset.asset_identification_format}"
90 | 


--------------------------------------------------------------------------------
/server/static/css/transaction_confirmation.css:
--------------------------------------------------------------------------------
 1 | .confirm-title {
 2 |   text-transform: capitalize;
 3 |   color: white;
 4 |   font-size: 1rem;
 5 |   line-height: 1;
 6 |   float: left;
 7 | }
 8 | 
 9 | .confirm-item {
10 |   padding: 1rem 0;
11 | }
12 | 
13 | .confirm-label {
14 |   text-transform: capitalize;
15 |   color: white;
16 |   font-size: 1rem;
17 |   line-height: 1;
18 |   float: left;
19 | }
20 | 
21 | .confirm-value {
22 |   color: white;
23 |   float: right;
24 |   line-height: 1rem;
25 |   font-size: 1rem;
26 | }
27 | 
28 | .hr {
29 |   margin-top: 1rem;
30 | }
31 | 
32 | .transaction-confirmation-info {
33 |   margin-bottom: 2rem;
34 | }


--------------------------------------------------------------------------------
/server/static/polaris/local-stellar.toml:
--------------------------------------------------------------------------------
 1 | ACCOUNTS = [ "GCSGSR6KQQ5BP2FXVPWRL6SWPUSFWLVONLIBJZUKTVQB5FYJFVL6XOXE", "GDRND2IUXVMHZ4XTB2RZ4AJ3AOLON3WTAOC23XEASB56NHDFW3ED57TW" ]
 2 | SIGNING_KEY = "GCUZ6YLL5RQBTYLTTQLPCM73C5XAIUGK2TIMWQH7HPSGWVS2KJ2F3CHS"
 3 | NETWORK_PASSPHRASE = "Test SDF Network ; September 2015"
 4 | 
 5 | TRANSFER_SERVER = "http://localhost:8000/sep6"
 6 | TRANSFER_SERVER_SEP0024 = "http://localhost:8000/sep24"
 7 | WEB_AUTH_ENDPOINT = "http://localhost:8000/auth"
 8 | KYC_SERVER = "http://localhost:8000/kyc"
 9 | DIRECT_PAYMENT_SERVER = "http://localhost:8000/sep31"
10 | ANCHOR_QUOTE_SERVER = "http://localhost:8000/sep38"
11 | 
12 | [[CURRENCIES]]
13 | code = "SRT"
14 | issuer = "GCDNJUBQSX7AJWLJACMJ7I4BC3Z47BQUTMHEICZLE6MU4KQBRYG5JY6B"
15 | status = "test"
16 | is_asset_anchored = false
17 | desc = "Stellar Reference Token (SRT) is an asset issued on testnet and is used as an anchored asset for this reference server for demonstration and testing purposes."
18 | 
19 | [DOCUMENTATION]
20 | ORG_NAME = "Stellar Development Foundation"
21 | ORG_URL = "https://stellar.org"
22 | ORG_DESCRIPTION = "The Stellar Development Foundation (SDF) is a non-profit organization whose mission is to create equitable access to the global financial system."
23 | ORG_GITHUB = "stellar"
24 | 


--------------------------------------------------------------------------------
/server/static/polaris/stellar.toml:
--------------------------------------------------------------------------------
 1 | ACCOUNTS = [ "GCSGSR6KQQ5BP2FXVPWRL6SWPUSFWLVONLIBJZUKTVQB5FYJFVL6XOXE", "GDRND2IUXVMHZ4XTB2RZ4AJ3AOLON3WTAOC23XEASB56NHDFW3ED57TW" ]
 2 | SIGNING_KEY = "GCUZ6YLL5RQBTYLTTQLPCM73C5XAIUGK2TIMWQH7HPSGWVS2KJ2F3CHS"
 3 | NETWORK_PASSPHRASE = "Test SDF Network ; September 2015"
 4 | 
 5 | TRANSFER_SERVER = "https://testanchor.stellar.org/sep6"
 6 | TRANSFER_SERVER_SEP0024 = "https://testanchor.stellar.org/sep24"
 7 | WEB_AUTH_ENDPOINT = "https://testanchor.stellar.org/auth"
 8 | KYC_SERVER = "https://testanchor.stellar.org/kyc"
 9 | DIRECT_PAYMENT_SERVER = "https://testanchor.stellar.org/sep31"
10 | ANCHOR_QUOTE_SERVER = "https://testanchor.stellar.org/sep38"
11 | 
12 | [[CURRENCIES]]
13 | code = "SRT"
14 | issuer = "GCDNJUBQSX7AJWLJACMJ7I4BC3Z47BQUTMHEICZLE6MU4KQBRYG5JY6B"
15 | status = "test"
16 | is_asset_anchored = false
17 | desc = "Stellar Reference Token (SRT) is an asset issued on testnet and is used as an anchored asset for this reference server for demonstration and testing purposes."
18 | 
19 | [[CURRENCIES]]
20 | code = "USDC"
21 | issuer = "GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5"
22 | status = "test"
23 | is_asset_anchored = false
24 | desc = "Circle USDC Token"
25 | 
26 | [DOCUMENTATION]
27 | ORG_NAME = "Stellar Development Foundation"
28 | ORG_URL = "https://stellar.org"
29 | ORG_DESCRIPTION = "The Stellar Development Foundation (SDF) is a non-profit organization whose mission is to create equitable access to the global financial system."
30 | ORG_GITHUB = "stellar"
31 | 


--------------------------------------------------------------------------------
/server/static/sep24_scripts/add_skip_confirmation_btn.js:
--------------------------------------------------------------------------------
 1 | (function () {
 2 |     let section = document.querySelector(".main-content").firstElementChild;
 3 |     let button = document.createElement("button");
 4 |     button.className = "button";
 5 |     button.innerHTML = "Skip Confirmation";
 6 |     button.setAttribute("test-action", "submit");
 7 |     button.addEventListener("click", function () {
 8 |         this.disabled = true;
 9 |         let url =
10 |             window.location.protocol +
11 |             "//" +
12 |             window.location.host +
13 |             "/skip_confirm_email";
14 |         fetch(url)
15 |             .then((res) => res.json())
16 |             .then((json) => {
17 |                 if (json["status"] === "not found") {
18 |                     // This would only happen if the PolarisStellarAccount doesn't exist.
19 |                     // It should always exist because the user needs to have an existing
20 |                     // account to access the confirm email page.
21 |                     let errElement = document.createElement("p");
22 |                     errElement.style = "color:red";
23 |                     errElement.innerHTML =
24 |                         "Error: Unable to skip confirmation step";
25 |                     errElement.align = "center";
26 |                     section.appendChild(document.createElement("br"));
27 |                     section.appendChild(errElement);
28 |                 } else {
29 |                     window.location.reload(true);
30 |                 }
31 |             });
32 |     });
33 |     section.appendChild(document.createElement("br"));
34 |     section.appendChild(button);
35 | })();
36 | 


--------------------------------------------------------------------------------
/server/static/sep24_scripts/check_email_confirmation.js:
--------------------------------------------------------------------------------
1 | window.addEventListener("load", () => {
2 |   window.addEventListener("focus", () => {
3 |     // Hit the /webapp endpoint again to check if the user's
4 |     // email has been confirmed.
5 |     window.location.reload(true);
6 |   });
7 | });
8 | 


--------------------------------------------------------------------------------
/server/static/sep24_scripts/google_analytics.js:
--------------------------------------------------------------------------------
1 | window.dataLayer = window.dataLayer || [];
2 | function gtag() {
3 |   dataLayer.push(arguments);
4 | }
5 | gtag("js", new Date());
6 | gtag("config", "UA-53373928-6");
7 | 


--------------------------------------------------------------------------------
/server/templates/email_confirmed.html:
--------------------------------------------------------------------------------
 1 | {% extends "polaris/base.html" %} {% load i18n %}
 2 | 
 3 | {% block "title" %}
 4 | <title>{% trans "Email Confirmed" %}</title>
 5 | {% endblock %}
 6 | 
 7 | {% block "content" %}
 8 | <section class="section">
 9 |     <h2>{% trans "Confirmed" %}</h2>
10 |     <p>{% trans "Your email has been confirmed! Please continue with your deposit or withdrawal on the original page." %}</p>
11 | </section>
12 | {% endblock %}
13 | 


--------------------------------------------------------------------------------
/server/templates/polaris/base.html:
--------------------------------------------------------------------------------
 1 | {% extends "polaris/base.html" %} {% load static %}
 2 | 
 3 | {% block "extra_body" %}
 4 | 
 5 |     <script src="https://www.googletagmanager.com/gtag/js?id=UA-53373928-6" async></script>
 6 |     <script src="{% static 'sep24_scripts/google_analytics.js' %}"></script>
 7 | 
 8 |     {% if not form and title == "Confirm Email" %}
 9 | 
10 |         {# Refresh the confirm email page whenever the user brings the popup #}
11 |         {# back into focus. This is not strictly necessary since deposit.html #}
12 |         {# and withdraw.html have 'Refresh' buttons, but this is a better UX. #}
13 |         <script src="{% static 'sep24_scripts/check_email_confirmation.js' %}"></script>
14 |         {# Add a "Skip Confirmation" button that will make a GET request to the #}
15 |         {# skip confirmation endpoint and reload the page. The email confirmation #}
16 |         {# functionality is just for sake of demonstration anyway. #}
17 |         <script src="{% static 'sep24_scripts/add_skip_confirmation_btn.js' %}"></script>
18 | 
19 |     {% endif %}
20 | 
21 | {% endblock %}


--------------------------------------------------------------------------------
/server/templates/polaris/more_info.html:
--------------------------------------------------------------------------------
 1 | {% extends "polaris/more_info.html" %} {% load i18n %} {% load tz %}
 2 | 
 3 | {% block "instructions" %}
 4 | {% if transaction.status == "pending_user_transfer_start" and "deposit" in transaction.kind %}
 5 | 
 6 | <div class="info-item">
 7 |     <div class="info-label">
 8 |         {% trans "instructions" %}
 9 |     </div>
10 |     <div class="field-value">
11 |         <p>{% trans "Include this code as the memo when making the deposit:" %} <strong>{{ memo }}</strong>. {% trans "We will use this memo to identify you as the sender." %}</p>
12 |         <br>
13 |         <p>{% trans "(This deposit is automatically confirmed for demonstration purposes. Please wait.)" %}</p>
14 |     </div>
15 | </div>
16 | 
17 | {% endif %}
18 | {% endblock %}
19 | 


--------------------------------------------------------------------------------
/server/templates/transaction_confirmation.html:
--------------------------------------------------------------------------------
 1 | {% extends "polaris/deposit.html" %} {% load i18n %} {% load static %}
 2 | 
 3 | {% block "extra_head" %}
 4 | <link rel="stylesheet" href="{% static 'css/transaction_confirmation.css' %}">
 5 | {% endblock %}
 6 | 
 7 | {% block "form" %}
 8 | <div class="transaction-confirmation-info">
 9 |   <div class="confirm-item" style="padding-top: 2rem">
10 |     <span class="confirm-title"><strong>Transaction Information</strong></span>
11 |   </div>
12 |   <hr>
13 |   <div class="confirm-item">
14 |     <span class="confirm-label">Transfer Amount</span>
15 |     <span class="confirm-value">{{ amount_in_symbol }} {{ amount_in|floatformat:amount_in_significant_decimals }}</span>
16 |   </div>
17 |   <div class="confirm-item">
18 |     <span class="confirm-label">Fee</span>
19 |     <span class="confirm-value">{{ amount_fee_symbol }} {{ amount_fee|floatformat:amount_fee_significant_decimals }}</span>
20 |   </div>
21 |   {% if price %}
22 |   <div class="confirm-item">
23 |     <span class="confirm-label">Exchange Amount</span>
24 |     <span class="confirm-value">{{ amount_in_symbol }} {{ conversion_amount|floatformat:amount_in_significant_decimals }}</span>
25 |   </div>
26 |   <div class="confirm-item">
27 |     <span class="confirm-label">Exchange Rate</span>
28 |     <span class="confirm-value">{{ amount_in_symbol }} 1.00 = {{amount_out_symbol}} {{ price|floatformat:price_significant_decimals }}</span>
29 |   </div>
30 |   {% endif %}
31 |   <div class="confirm-item">
32 |     {% if operation == "deposit" %}
33 |     <span class="confirm-label"><strong>Deposit Amount:</strong></span>
34 |     {% else %}
35 |     <span class="confirm-label"><strong>Withdraw Amount:</strong></span>
36 |     {% endif %}
37 |     <span class="confirm-value"><strong>{{ amount_out_symbol }} {{ amount_out|floatformat:amount_out_significant_decimals }}</strong></span>
38 |   </div>
39 | </div>
40 | <form method="post" action="{{ post_url }}">
41 |   <div class="field at-bottom">
42 |     <div class="control">
43 |       <button class="button submit" type="submit">{% trans "Confirm Transaction" %}</button>
44 |     </div>
45 |   </div>
46 | </form>
47 | {% endblock %}
48 | 


--------------------------------------------------------------------------------
/server/urls.py:
--------------------------------------------------------------------------------
 1 | """app URL Configuration
 2 | The `urlpatterns` list routes URLs to views. For more information please see:
 3 |     https://docs.djangoproject.com/en/2.2/topics/http/urls/
 4 | Examples:
 5 | Function views
 6 |     1. Add an import:  from my_app import views
 7 |     2. Add a URL to urlpatterns:  path('', views.home, name='home')
 8 | Class-based views
 9 |     1. Add an import:  from other_app.views import Home
10 |     2. Add a URL to urlpatterns:  path('', Home.as_view(), name='home')
11 | Including another URLconf
12 |     1. Import the include() function: from django.urls import include, path
13 |     2. Add a URL to urlpatterns:  path('blog', include('blog.urls'))
14 | """
15 | from django.urls import path, include
16 | 
17 | import polaris.urls
18 | from .views import all_fields_form_view, confirm_email, skip_confirm_email, log_callback
19 | 
20 | urlpatterns = [
21 |     path("all-fields", all_fields_form_view),
22 |     path("confirm_email", confirm_email, name="confirm_email"),
23 |     path("skip_confirm_email", skip_confirm_email, name="skip_confirm_email"),
24 |     path("onChangeCallback", log_callback),
25 |     path("", include(polaris.urls)),
26 | ]
27 | 


--------------------------------------------------------------------------------
/server/views.py:
--------------------------------------------------------------------------------
 1 | import json
 2 | from logging import getLogger
 3 | from django.utils.translation import gettext as _
 4 | 
 5 | from rest_framework.request import Request
 6 | from rest_framework.response import Response
 7 | from rest_framework.decorators import api_view, renderer_classes
 8 | from rest_framework.renderers import TemplateHTMLRenderer, JSONRenderer
 9 | 
10 | from .forms import AllFieldsForm
11 | from .models import PolarisStellarAccount
12 | from polaris.utils import render_error_response
13 | 
14 | 
15 | logger = getLogger(__name__)
16 | 
17 | 
18 | @api_view(["GET"])
19 | @renderer_classes([TemplateHTMLRenderer])
20 | def all_fields_form_view(request: Request) -> Response:
21 |     return Response(
22 |         {
23 |             "form": AllFieldsForm(),
24 |             "guidance": _("This form contains every field type."),
25 |         },
26 |         template_name="polaris/deposit.html",
27 |     )
28 | 
29 | 
30 | @api_view(["GET"])
31 | @renderer_classes([TemplateHTMLRenderer])
32 | def confirm_email(request: Request) -> Response:
33 |     if not (request.GET.get("token") and request.GET.get("email")):
34 |         return render_error_response(
35 |             "email and token arguments required.", content_type="text/html"
36 |         )
37 | 
38 |     try:
39 |         account = PolarisStellarAccount.objects.get(
40 |             user__email=request.GET.get("email"),
41 |             confirmation_token=request.GET.get("token"),
42 |         )
43 |     except PolarisStellarAccount.DoesNotExist:
44 |         return render_error_response(
45 |             "User with email and token does not exist", content_type="text/html"
46 |         )
47 | 
48 |     account.confirmed = True
49 |     account.save()
50 | 
51 |     return Response(template_name="email_confirmed.html")
52 | 
53 | 
54 | @api_view(["GET"])
55 | @renderer_classes([JSONRenderer])
56 | def skip_confirm_email(request: Request) -> Response:
57 |     account = request.session.get("account")
58 |     num_updated = PolarisStellarAccount.objects.filter(account=account).update(
59 |         confirmed=True
60 |     )
61 |     if num_updated == 0:
62 |         return Response(
63 |             {"status": "not found"}, status=404, content_type="application/json"
64 |         )
65 |     else:
66 |         if num_updated > 1:
67 |             logger.warning(
68 |                 f"Approved multiple PolarisStellarAccounts for address: {account}"
69 |             )
70 |         return Response({"status": "success"}, content_type="application/json")
71 | 
72 | 
73 | @api_view(["POST"])
74 | @renderer_classes([JSONRenderer])
75 | def log_callback(request):
76 |     """
77 |     The URL for this endpoint is can be used by clients as the on_change_callback URL
78 |     to test Polaris' on_change_callback requests.
79 |     """
80 |     logger.info(
81 |         f"on_change_callback request received: {json.dumps(request.data, indent=2)}"
82 |     )
83 |     return Response({"status": "ok"}, status=200)
84 | 


--------------------------------------------------------------------------------
/server/wsgi.py:
--------------------------------------------------------------------------------
 1 | """
 2 | WSGI config for app project.
 3 | It exposes the WSGI callable as a module-level variable named ``application``.
 4 | For more information on this file, see
 5 | https://docs.djangoproject.com/en/2.2/howto/deployment/wsgi/
 6 | """
 7 | 
 8 | import os
 9 | 
10 | from django.core.wsgi import get_wsgi_application
11 | 
12 | os.environ.setdefault("DJANGO_SETTINGS_MODULE", "settings")
13 | 
14 | application = get_wsgi_application()
15 | 


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