> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trusset.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Log Deployed Token

> Register an externally deployed stock token with the Trusset platform

Registers a stock token contract that was deployed outside the Trusset platform (e.g., via a direct on-chain transaction or third-party tool). This links the existing contract to the authenticated instance so it can be managed through the API.

Use this when you deploy contracts independently but still want Trusset to track issuance, holders, and compliance.

## Request Body

<ParamField body="tokenAddress" type="string" required>
  Address of the already-deployed token contract. Must be a valid Ethereum address.
</ParamField>

<ParamField body="name" type="string" required>
  Token name.
</ParamField>

<ParamField body="symbol" type="string" required>
  Token ticker symbol.
</ParamField>

<ParamField body="isin" type="string" required>
  ISIN identifier for the underlying security.
</ParamField>

<ParamField body="metadataURI" type="string">
  URI pointing to off-chain token metadata.
</ParamField>

<ParamField body="issuerAddress" type="string">
  Ethereum address of the token issuer.
</ParamField>

<ParamField body="legalOperatorAddress" type="string">
  Ethereum address of the legal operator.
</ParamField>

<ParamField body="deployTxHash" type="string">
  Transaction hash of the original deployment, for audit trail purposes.
</ParamField>

<ParamField body="allowSubIssuers" type="boolean" default="false">
  Whether the sub-issuer role is enabled on this token.
</ParamField>

## Response Fields

<ResponseField name="success" type="boolean">Request status.</ResponseField>

<ResponseField name="data" type="object">
  The registered token record.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.trusset.org/stocks/api/tokenization/log-deploy" \
    -H "Content-Type: application/json" \
    -H "X-API-Key: trusset_bc123xy_secret..." \
    -d '{
      "tokenAddress": "0x1234567890abcdef1234567890abcdef12345678",
      "name": "Acme Corp Equity",
      "symbol": "ACME",
      "isin": "DE000A0D9PT0",
      "issuerAddress": "0xAbC123dEf456789012345678901234567890AbCd",
      "deployTxHash": "0xabc123..."
    }'
  ```

  ```typescript TypeScript theme={null}
  const response = await fetch(
    'https://api.trusset.org/stocks/api/tokenization/log-deploy',
    {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'X-API-Key': 'trusset_bc123xy_secret...'
      },
      body: JSON.stringify({
        tokenAddress: '0x1234567890abcdef1234567890abcdef12345678',
        name: 'Acme Corp Equity',
        symbol: 'ACME',
        isin: 'DE000A0D9PT0',
        issuerAddress: '0xAbC123dEf456789012345678901234567890AbCd',
        deployTxHash: '0xabc123...'
      })
    }
  );
  const { data } = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "tokenAddress": "0x1234567890abcdef1234567890abcdef12345678",
      "name": "Acme Corp Equity",
      "symbol": "ACME",
      "isin": "DE000A0D9PT0",
      "instanceId": "inst_abc123"
    },
    "metadata": {
      "requestId": "550e8400-e29b-41d4-a716-446655440000",
      "timestamp": "2025-06-15T12:00:00.000Z",
      "instanceId": "inst_abc123"
    }
  }
  ```
</ResponseExample>